{"uid":"cap_uGwoN7RiX6w-N_t51ngWX","slug":"x402node-crypto-token-supply-lookup-0e416e73","name":"x402node Crypto Token Supply Lookup","description":"Token supply data by symbol via CoinGecko. Pass symbol=BTC (or ETH, SOL...) and get circulating, total and max supply, circulating ratio %, market cap and fully-diluted valuation. Batch with commas. For AI agents needing token supply, circulating supply and tokenomics. 代币供应量查询。","url":"https://api.x402node.dev/crypto/supply","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":["symbol","id"],"properties":{"id":{"type":"string","description":"CoinGecko id(s) for coins not in ticker map, e.g. bitcoin. Alias: ids."},"symbol":{"type":"string","description":"Token ticker(s), e.g. BTC or BTC,ETH,SOL (batch). Common tickers auto-mapped. Alias: symbols."}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0022","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.0022/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0022","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0022","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_7j6iqb95T30gjz5q5zWAA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0022","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns circulating, total, and max supply data along with market cap and fully-diluted valuation for one or more cryptocurrency tokens by ticker symbol or CoinGecko ID.","exampleAgentPrompt":"Can you pull the circulating supply, total supply, max supply, and market cap for BTC, ETH, and SOL — I want to compare their circulating ratios and fully-diluted valuations?","exampleUseCases":null,"resultDescription":"Returns for each requested token: circulating supply, total supply, max supply, circulating ratio as a percentage, market cap in USD, and fully-diluted valuation (FDV) sourced from CoinGecko.","failureModes":["Unknown or misspelled ticker symbol returns an error or empty result","CoinGecko ID not found when using the 'id' parameter returns no data","Batch request with one invalid symbol may cause partial or full failure","Rate limiting or upstream CoinGecko downtime returns a 5xx error","Missing both 'symbol' and 'id' parameters results in a validation error"],"whenToPreferThis":"Use this endpoint when you need token supply and tokenomics data (circulating, total, max supply, circulating ratio, market cap, FDV) for one or more cryptocurrencies by ticker symbol. Prefer it over general crypto price endpoints when supply-side metrics are the primary concern. Use the batch (comma-separated) feature when querying multiple tokens to minimize cost and latency.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:59:09.059Z","isFirstParty":false}