{"uid":"cap_NLnOQgQdmOVAsQmPgWX2c","slug":"agent402-coins-list-0cca6c6c","name":"Agent402 Coins List","description":"The complete list of tracked coins (~18k) as {id, symbol, name}, paged: `page` + `perPage` (1-500, default 250). `includePlatforms: true` adds each coin's contract address per platform; `platform` (e.g. base, solana, ethereum) keeps only coins with a contract there; `symbol` keeps one ticker (exact, case-insensitive) across all its namesakes. For bulk id resolution, building a local symbol map, or enumerating every token on one chain; for a single lookup use coin-search.","url":"https://agent402.tools/api/coins-list","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","properties":{"page":{"type":"number","description":"Page number (default 1)."},"symbol":{"type":"string","description":"Keep only coins with this ticker symbol (exact, case-insensitive)."},"perPage":{"type":"number","description":"Rows per page, 1-500 (default 250)."},"platform":{"type":"string","description":"Keep only coins with a contract on this platform id (implies includePlatforms)."},"includePlatforms":{"type":"boolean","description":"Include contract addresses per platform (default false)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["source","fetchedAt","cached","page","perPage","total","totalPages","count","filters","coins"],"properties":{"page":{"type":"integer"},"coins":{"type":"array","items":{"type":"object"}},"count":{"type":"integer"},"total":{"type":"integer"},"cached":{"type":"boolean"},"source":{"type":"string"},"filters":{"type":"object","properties":{"symbol":{"type":"string"},"platform":{}}},"perPage":{"type":"integer"},"fetchedAt":{"type":"string"},"totalPages":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"page":1,"coins":[{"id":"usd-coin","name":"USDC","symbol":"usdc","platforms":{"base":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","solana":"EPjFWdd5AuFqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","ethereum":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"}}],"count":3,"total":3,"cached":false,"source":"coingecko","filters":{"symbol":"usdc","platform":null},"perPage":250,"fetchedAt":"2026-08-22T13:20:00.000Z","totalPages":1}},"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_H6EuQ7s1KW2uDKRb9KYH6","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":"Returns a paginated, filterable list of cryptocurrency coins with IDs, symbols, names, and optional contract addresses per blockchain platform","exampleAgentPrompt":"Can you get me the coin list filtered to just USDC, including contract addresses across all platforms?","exampleUseCases":[{"title":"Resolve token contract address by symbol","prompt":"I need the contract addresses for USDC on Ethereum, Base, and Solana — can you look that up from the coins list with platform data included?"},{"title":"Build crypto token directory","prompt":"Fetch the full list of supported coins, 500 per page starting at page 1, so I can index them for our token search feature."},{"title":"Find CoinGecko ID for a ticker","prompt":"What's the CoinGecko coin ID for the ticker symbol 'SOL'? Search the coins list filtered by that symbol."}],"resultDescription":"A JSON object containing a paginated array of coin objects (each with id, name, symbol, and optionally a platforms map of blockchain IDs to contract addresses), plus metadata: total count, current page, total pages, results per page, applied filters, data source (CoinGecko), cache status, and fetch timestamp.","failureModes":["Invalid or unknown platform ID returns an empty coins array rather than an error","Symbol filter is case-insensitive but must be an exact match — partial ticker matches return no results","perPage values outside 1–500 may be rejected or clamped","Stale cache may return slightly outdated coin data (fetchedAt timestamp indicates age)","Payment of 0.005 USDC required per call — insufficient wallet balance results in 402 response"],"whenToPreferThis":"Use this endpoint when you need a structured, filterable index of cryptocurrency coins with CoinGecko IDs and optional multi-chain contract addresses, especially when operating in a pay-per-call agent context without API keys. Prefer it over direct CoinGecko API calls when your agent uses x402/MPP payment rails and needs no signup. Best suited for resolving token symbols to IDs or finding on-chain contract addresses across platforms.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T07:02:48.675Z","isFirstParty":false}