{"uid":"cap_dMo2PihiDfuDr3---bp0P","slug":"token-supply-market-data-lookup-d1495df3","name":"Token Supply & Market Data Lookup","description":"Total supply, holder count, decimals, and live USD price / market cap for any ERC-20/721 token contract, across Base, Ethereum, Optimism, Arbitrum, Polygon, Gnosis. The supply read trading, valuation, and risk agents make to size circulating supply, dilution, and holder distribution before pricing or trading a token. Free upstream (Blockscout); one paid call instead of running your own RPC.","url":"https://store.agentexchange.work/chain/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":["address"],"properties":{"chain":{"type":"string","description":"base|ethereum|optimism|arbitrum|polygon|gnosis (default ethereum)"},"address":{"type":"string","description":"Token contract address (0x...)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"holders":{"type":"number"},"usd_price":{"type":"number"},"total_supply":{"type":"number"}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"chain":"ethereum","address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"}}},"response":{"name":"USDC","type":"ERC-20","chain":"ethereum","signal":"Size circulating supply, dilution and holder distribution before pricing or trading a token.","source":"Blockscout v2 (live)","symbol":"USDC","address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","holders":7836699,"license":"single-use","decimals":6,"served_at":1781732975537,"usd_price":0.999753,"market_cap":74726959977.77864,"total_supply":51729156374.17669,"total_supply_raw":"51729156374176685"}},"exampleRequest":{"chain":"ethereum","address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"},"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.09","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.09","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_NVlWE9wAyDcZG2Li-GsaG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.09","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns total supply, holder count, price, market cap, and metadata for a given ERC-20 token contract address on a specified blockchain.","exampleAgentPrompt":"What's the total supply, holder count, and current USD price for USDC at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum?","exampleUseCases":null,"resultDescription":"A JSON object containing the token's name, symbol, contract address, chain, total supply (in token units), number of holders, current USD price, market cap in USD, and decimal precision — sourced from on-chain reads.","failureModes":["Invalid or non-existent contract address returns an error or empty response","Unsupported chain value causes a 400 or validation error","Token exists on chain but has no indexed holder data, resulting in null holders field","Network timeout or RPC unavailability causes a 500-level error","Non-ERC-20 contract address may return malformed or incomplete data"],"whenToPreferThis":"Use this endpoint when you need on-chain token supply, holder count, price, and market cap data for a specific ERC-20 contract across major EVM chains (Ethereum, Base, Optimism, Arbitrum, Polygon, Gnosis) without requiring API key signup — paying only $0.001 USDC per call via x402.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:51:32.327Z","isFirstParty":false}