{"uid":"cap_F0D0m1Qku7recmmTH9ktI","slug":"hypurr-claw-hyperliquid-market-search-772f7232","name":"Hypurr Claw Hyperliquid Market Search","description":"Text-search Hyperliquid perp and spot markets by name (e.g. oil, copper, purr) across all perp dexes unless dex is set. Returns human-readable name/coin plus exchange assetId and spotPairId for each hit. Read-only.","url":"https://hypurrclaw.xyz/x402/tools/searchHyperliquidMarkets","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","inputSchema"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"dex":{"type":"string","maxLength":32},"limit":{"type":"integer","maximum":100,"minimum":1},"query":{"type":"string","maxLength":64,"minLength":1},"includePerp":{"type":"boolean"},"includeSpot":{"type":"boolean"}},"additionalProperties":true},"description":{"type":"string"},"inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["query"],"properties":{"dex":{"type":"string","maxLength":32},"limit":{"type":"integer","maximum":100,"minimum":1},"query":{"type":"string","maxLength":64,"minLength":1},"includePerp":{"type":"boolean"},"includeSpot":{"type":"boolean"}},"additionalProperties":false}},"additionalProperties":true},"output":{"type":"object","additionalProperties":true}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.050000","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.050000/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LBscBhnM0k96ssbs2nnaZ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Text-search Hyperliquid perpetual and spot markets by commodity or token name across all or a specific DEX","exampleAgentPrompt":"Search Hyperliquid markets for anything related to 'gold' — include both perp and spot, and show me up to 20 results.","exampleUseCases":[{"title":"Find oil perp markets on Hyperliquid","prompt":"Search Hyperliquid for any markets related to 'oil' — I want to see if there are perpetual contracts I can trade for crude or energy commodities."},{"title":"Look up copper spot trading pairs","prompt":"Can you find all Hyperliquid spot markets that match 'copper'? I'm not sure what the exact ticker is, so just search by name and show me everything that comes up."},{"title":"Discover BTC-related Hyperliquid markets","prompt":"Search Hyperliquid for anything with 'BTC' in the name across both perp and spot markets — I want to see all the related pairs available before I decide where to trade."}],"resultDescription":"A list of matching Hyperliquid markets (perp and/or spot) whose names match the text query, including market identifiers, type (perp or spot), and DEX information, filtered and ranked by relevance to the search term.","failureModes":["Empty results if no markets match the query string","Query too long (over 64 chars) returns validation error","Limit out of range (must be 1-100) returns validation error","Unknown DEX name returns empty or error response","Network or payment failure returns HTTP 402 or 5xx"],"whenToPreferThis":"Use this endpoint when you need to discover which Hyperliquid markets exist for a given commodity or token by name — especially useful for non-crypto underlyings like oil, gold, or copper where exact ticker symbols are unknown. Prefer this over manually enumerating markets or scraping Hyperliquid docs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:32:56.110Z","isFirstParty":false}