{"uid":"cap_fyEbQe-Aql7mCV8zh0cl1","slug":"agent-data-tools-revmesh2074-workers-dev-erc-20-token-total-supply-2317a9d1","name":"ERC-20 Token Total Supply Lookup","description":"Total supply of any ERC-20 token on Ethereum, Base, Arbitrum, Optimism or Polygon, read live from the contract: raw and decimal-adjusted supply, decimals, name and symbol. Give a 0x address or a known ticker (USDC, USDT, WETH, DAI…). Use to check a token's circulating maximum or compare supply across chains.","url":"https://agent-data-tools.revmesh2074.workers.dev/token/supply?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["token"],"properties":{"chain":{"type":"string","description":"ethereum (default), base, arbitrum, optimism or polygon"},"token":{"type":"string","description":"Token 0x address or ticker"}}},"responseSchema":{"type":"object","properties":{"name":{"type":"string"},"chain":{"type":"string"},"token":{"type":"string"},"symbol":{"type":"string"},"decimals":{"type":"number"},"totalSupply":{"type":"number"},"totalSupplyRaw":{"type":"string"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USD","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_U_k2t5FLlksZY4TLJqhvR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agent-data-tools.revmesh2074.workers.dev","brandSlug":"agent-data-tools-revmesh2074-workers-dev-x402","brandBaseUrl":"https://agent-data-tools.revmesh2074.workers.dev","brandDocsUrl":null,"whatItDoes":"Returns the live total supply (raw and decimal-adjusted), decimals, name, and symbol of any ERC-20 token on Ethereum, Base, Arbitrum, Optimism, or Polygon.","exampleAgentPrompt":"What's the current total supply of USDC on Ethereum — give me both the raw number and the decimal-adjusted amount?","exampleUseCases":[{"title":"Compare USDC supply across chains","prompt":"Can you check the total supply of USDC on Ethereum, Base, and Arbitrum so I can compare how much is issued on each chain?"},{"title":"Verify token supply for a DeFi audit","prompt":"I need the total supply, decimals, name, and symbol for the token at 0x6B175474E89094C44Da98b954EedeAC495271d0F on Ethereum — that's DAI."},{"title":"Monitor USDT inflation over time","prompt":"What is the current total supply of USDT on Polygon right now? I want to track whether it's been increasing."}],"resultDescription":"Returns a JSON object with the token's name, symbol, decimals, chain, contract address, decimal-adjusted total supply (totalSupply as a number), and raw total supply string (totalSupplyRaw). Values are read live from the on-chain contract at query time.","failureModes":["Unknown ticker or invalid 0x address returns an error — ensure the token identifier is correct for the specified chain","Token not deployed on the selected chain returns a contract-not-found or zero-supply error","Network congestion or RPC issues may cause timeouts","Tokens with non-standard ERC-20 interfaces may not return all fields correctly"],"whenToPreferThis":"Choose this endpoint when you need live, on-chain total supply data for any ERC-20 token across Ethereum, Base, Arbitrum, Optimism, or Polygon. It supports both friendly tickers (USDC, USDT, WETH, DAI) and raw contract addresses, making it convenient without needing to look up addresses first. Prefer it over off-chain aggregators when accuracy and freshness matter, or when comparing supply across multiple chains programmatically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T07:21:37.458Z","isFirstParty":false,"canonicalSlug":"agent-data-tools-revmesh2074-workers-dev-erc-20-token-total-supply-2317a9d1"}