{"uid":"cap_o6gbhfQZr9omn-MYrilsg","slug":"erc20-token-supply-info-lookup-350631f3","name":"ERC20 Token Supply & Info Lookup","description":"Total supply, name, symbol and decimals for any ERC20 token contract on Ethereum, Base, Arbitrum, Optimism or Polygon. token supply, erc20 total supply, circulating supply, token info, coin supply Accepts payment on Base or Solana — either network works.","url":"https://api.x402node.dev/chain/erc20-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":"ethereum, base (default), arbitrum, optimism, polygon"},"token":{"type":"string","description":"ERC20 contract address (optional)"},"address":{"type":"string","description":"ERC20 contract address (required)"}}}},"additionalProperties":false}}},"responseSchema":null,"example":{"request":{"chain":"ethereum","address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"},"response":{"name":"USD Coin","_hint":"x402 paid endpoints for AI agents — x402node.dev (utilities) · cn402.com (Chinese culture)","chain":"ethereum","symbol":"USDC","contract":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","decimals":6,"totalSupply":{"raw":"51938146548945407","formatted":"51938146548.945407"}}},"exampleRequest":{"chain":"ethereum","address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"},"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mKgRt-0KPgB1Qmv0WzZBr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns total supply, name, symbol, and decimals for any ERC20 token contract on Ethereum, Base, Arbitrum, Optimism, or Polygon","exampleAgentPrompt":"What's the total supply, symbol, and decimals for the ERC20 token at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum mainnet?","exampleUseCases":null,"resultDescription":"Returns a JSON object with the token's total supply (as a raw and/or human-readable number), token name, ticker symbol, and decimal precision — all read directly from the ERC20 contract on the specified chain.","failureModes":["Invalid or non-existent contract address returns an error","Contract address is not an ERC20 token (e.g. ERC721 or EOA) returns an error or null fields","Unsupported chain ID returns an error","RPC node unavailability causes timeout or 5xx error","Malformed address format returns a 400 bad request"],"whenToPreferThis":"Use this endpoint when you need on-chain ERC20 metadata — total supply, name, symbol, or decimals — for a token on Ethereum, Base, Arbitrum, Optimism, or Polygon, without needing price data or off-chain market information. Prefer this over CoinGecko-style endpoints when you have a contract address and need raw supply data directly from the contract.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:51:30.813Z","isFirstParty":false}