{"uid":"cap_J2OLbWTd4tZAST3e-pooF","slug":"token-supply-market-data-lookup-by-contract-address-661325a8","name":"Token Supply & Market Data Lookup by Contract Address","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://x402-agent-store.rileycraig14.workers.dev/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":{"type":"json","example":{"name":"USD Coin","chain":"ethereum","symbol":"USDC","address":"0x...","holders":1842000,"decimals":6,"usd_price":1,"market_cap":24500000000,"total_supply":24500000000}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_YCN3BA50X8fqDt73VHl0i","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns on-chain token metadata including total supply, holder count, USD price, market cap, and decimals for a given ERC-20 contract address across multiple EVM chains.","exampleAgentPrompt":"What is the total supply, holder count, and USD price for the USDC token at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum?","exampleUseCases":null,"resultDescription":"A JSON object containing the token's name, symbol, contract address, chain, total supply (raw integer), number of holders, USD price, market cap in USD, and decimal precision — all sourced from on-chain reads.","failureModes":["Invalid or non-existent contract address returns an error or empty response","Unsupported chain name causes a validation error","Token with no holder data may return holders as null or 0","Non-ERC-20 contract address may return malformed or missing fields","Rate limits or payment failure (402) if USDC payment is not properly attached"],"whenToPreferThis":"Use this endpoint when you need on-chain token supply, holder count, or price data for a specific ERC-20 contract address across major EVM chains (Ethereum, Base, Arbitrum, Optimism, Polygon, Gnosis). Prefer this over general market APIs when you have the contract address and want canonical on-chain figures rather than exchange-reported data. It requires no API key — only a micro-payment of $0.001 USDC via x402 on Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:42:34.059Z","isFirstParty":false}