{"uid":"cap_rzwLvSPW83a0doAgViGwX","slug":"erc-20-token-total-supply-d4f3f7e1","name":"ERC-20 Token Total Supply","description":"Total supply for an ERC-20 token contract, from Etherscan's V2 API. Raw value only, no market data -- for price/market cap use /crypto-prices instead. $0.005/call.","url":"https://www.x402financialdata.com/token-supply/:contract_address","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","HEAD","DELETE"],"type":"string"},"pathParams":{"type":"object","required":["contract_address"],"properties":{"contract_address":{"type":"string","description":"ERC-20 token contract address"}}},"queryParams":{"type":"object","required":[],"properties":{"chain":{"enum":["eth"],"type":"string","description":"Which chain to query. Only 'eth' is supported right now."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"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_qrK_ijXkogGaxhMBxlBeu","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 the raw total supply for a given ERC-20 token contract address on Ethereum mainnet, sourced from Etherscan V2.","exampleAgentPrompt":"What is the total supply of USDC? The contract address on Ethereum is 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48.","exampleUseCases":[{"title":"Verify token supply for a new DeFi project","prompt":"Can you check the total supply of this new DeFi token on Ethereum? The contract address is 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984."},{"title":"Monitor inflation of a stablecoin","prompt":"What is the current raw total supply of DAI on Ethereum mainnet? Contract address is 0x6B175474E89094C44Da98b954EedeAC495271d0F."},{"title":"Compare circulating supply across tokens","prompt":"Fetch the total supply for both USDT at 0xdAC17F958D2ee523a2206206994597C13D831ec7 and USDC at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum so I can compare them."}],"resultDescription":"A raw integer value representing the total supply of the specified ERC-20 token as recorded on the Ethereum blockchain via Etherscan V2. No price, market cap, or decimals-adjusted value is included.","failureModes":["Invalid or non-existent contract address returns an error or zero value","Contract address is not an ERC-20 token (e.g. ERC-721 NFT) and may return unexpected data","Only Ethereum mainnet ('eth') is supported; requests for other chains will fail","Rate limiting or Etherscan API downtime may cause transient failures","Malformed contract address format returns a validation error"],"whenToPreferThis":"Use this endpoint when you need the raw on-chain total supply of an ERC-20 token on Ethereum mainnet and nothing more. It is ideal for supply audits, inflation tracking, or enriching token metadata pipelines. Do not use it for price or market cap data (use /crypto-prices instead), for tokens on chains other than Ethereum, or for non-ERC-20 contracts.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:53:23.002Z","isFirstParty":false}