{"uid":"cap_TvFfA0ZpVSxS5H0l3MhoZ","slug":"hyperliquid-market-search-406fcd86","name":"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://enchanted-oyster-554.convex.site/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_P2B8nZluFjLK7yaGdl2Jp","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 name (e.g. oil, copper, gold) across all perp DEXes or a specific one","exampleAgentPrompt":"Search Hyperliquid perp and spot markets for 'gold' and return up to 20 results so I can see what gold-related markets are available.","exampleUseCases":null,"resultDescription":"A list of matching Hyperliquid markets (perp and/or spot) that contain the search query in their name, including market metadata such as market name and DEX. Results are filtered based on query string, market type inclusion flags, and optional DEX scope, up to the specified limit.","failureModes":["Empty result set if no markets match the query string","Query string too long (>64 chars) causes validation error","Limit out of range (<1 or >100) causes validation error","DEX name not recognized returns empty or error","Network or Convex backend unavailability returns 5xx","Payment failure (x402) if USDC not provided or insufficient"],"whenToPreferThis":"Use this endpoint when you need to discover or confirm which Hyperliquid perpetual or spot markets exist for a given asset name before trading, monitoring, or analysis. Prefer this over hardcoding market names, especially for commodity or non-standard asset searches. Best suited for pre-trade discovery flows on Hyperliquid DEXes.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:34:55.439Z","isFirstParty":false}