{"uid":"cap_4zq6T5NspxLm0mywzFG2o","slug":"agent402-coin-search-ac4449c9","name":"Agent402 Coin Search","description":"Resolve a name or ticker to coin ids: full-text search returning matching coins (id, symbol, name, market cap rank, ordered by rank), exchanges (id, name, market type) and categories (id, name), plus NFT collections. `limit` per group 1-50 (default 10). The id resolver for every other coin tool: an agent holding \"PEPE\" or \"render\" gets the canonical id here before calling coin-profile, coin-ohlc or coin-history. Cached in-process for 5 minutes.","url":"https://agent402.tools/api/coin-search","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["query"],"properties":{"limit":{"type":"number","description":"Max results per group, 1-50 (default 10)."},"query":{"type":"string","description":"Name, symbol or fragment, 1-64 chars (e.g. \"usdc\", \"render\", \"pepe\")."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["source","fetchedAt","cached","query","counts","coins","exchanges","categories","nfts"],"properties":{"nfts":{"type":"array"},"coins":{"type":"array"},"query":{"type":"string"},"cached":{"type":"boolean"},"counts":{"type":"object"},"source":{"type":"string"},"exchanges":{"type":"array"},"fetchedAt":{"type":"string"},"categories":{"type":"array"}}}}}}},"responseSchema":{"type":"json","example":{"nfts":[],"coins":[{"id":"usd-coin","name":"USDC","rank":6,"symbol":"USDC"}],"query":"usdc","cached":false,"counts":{"nfts":0,"coins":5,"exchanges":0,"categories":1},"source":"coingecko","exchanges":[],"fetchedAt":"2026-08-22T13:20:00.000Z","categories":[{"id":"usdc-stablecoins","name":"USDC Stablecoins"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_er5j-DNNopVekNWI5YlWb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search for cryptocurrencies, NFTs, exchanges, and categories by name, symbol, or partial query via CoinGecko data","exampleAgentPrompt":"Search for coins matching 'render' on CoinGecko and show me the top 5 results with their IDs, symbols, and ranks.","exampleUseCases":[{"title":"Resolve ticker to CoinGecko ID","prompt":"I need the CoinGecko ID for the USDC stablecoin — can you search for 'usdc' and tell me its exact ID and current rank?"},{"title":"Discover tokens by partial name","prompt":"Search for any coins with 'pepe' in the name and show me up to 10 results including their symbols and ranks."},{"title":"Find coin category for a token","prompt":"Look up 'render' on CoinGecko and tell me what coin categories it belongs to, as well as its symbol and rank."}],"resultDescription":"A JSON object containing arrays of matching coins (with id, name, symbol, rank), NFTs, exchanges, and categories; plus the original query string, per-group result counts, the data source (coingecko), a cached flag, and a fetchedAt timestamp.","failureModes":["Query string missing or empty returns validation error","Query longer than 64 characters rejected","Limit out of range (must be 1–50) returns error","No matching results returns empty arrays with zero counts","Upstream CoinGecko API unavailable may return error or stale cached data","Payment failure (insufficient USDC) blocks the call at the x402 layer"],"whenToPreferThis":"Choose this endpoint when you need to resolve a human-readable coin name or ticker symbol to a canonical CoinGecko ID, discover coins by partial name fragment, or retrieve basic coin metadata (rank, symbol) without needing full price or OHLCV data. It is well-suited for agent workflows that must identify tokens before making further price or market calls, and works without API keys — payment is handled per-call in USDC via x402.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:58:51.448Z","isFirstParty":false}