{"uid":"cap_Kj-nnYqd9OnpMSexydOwV","slug":"tokensupply-erc-20-token-total-supply-5e3642b0","name":"Tokensupply - ERC-20 Token Total Supply","description":"Pay-per-request access to CoinGecko, DefiLlama, Alchemy, and Etherscan APIs. No auth, no subscriptions.","url":"https://stablecrypto.dev/api/etherscan/token/tokensupply","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chainid":{"type":"number","description":"EVM chain ID (1=Ethereum, 137=Polygon, 8453=Base, etc.)"},"contractaddress":{"type":"string","description":"ERC-20 token contract address"}}},"responseSchema":null,"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_A6uEqHvmbItOZNVZ9v58w","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 the total supply of an ERC-20 token given a contract address and EVM chain ID","exampleAgentPrompt":"What's the total supply of the USDC token (contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) on Ethereum mainnet (chain ID 1)?","exampleUseCases":null,"resultDescription":"The total token supply of the specified ERC-20 contract on the given EVM chain, expressed as a numeric value (typically in the token's smallest unit, e.g. wei-equivalent)","failureModes":["Invalid or non-ERC-20 contract address returns an error or zero","Unsupported chain ID returns an error","Contract address not found on specified chain","Network timeout or upstream Etherscan API unavailability","Malformed contract address format causes a validation error"],"whenToPreferThis":"Use this endpoint when you need to look up the on-chain total supply of any ERC-20 token across EVM-compatible chains (Ethereum, Polygon, Base, etc.) via Etherscan data. Prefer this over generic RPC calls when you want a simple, direct total supply figure without manually crafting a JSON-RPC totalSupply call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:54:01.869Z","isFirstParty":false}