{"uid":"cap_bwS80K1GORuw8x2a2HD_3","slug":"erc20-erc721-total-supply-lookup-76112fc6","name":"ERC20/ERC721 Total Supply Lookup","description":"Total supply of an ERC20 or ERC721 token via totalSupply (eth_call), formatted with decimals and symbol. Example: {token:\"0x8335…2913\", chain:\"base\"} → {total_supply, symbol, decimals}. $0.001.","url":"https://api.axiomworks.co.uk/chain/total-supply?utm_source=zero.xyz","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":["token"],"properties":{"chain":{"enum":["base","ethereum","arbitrum","optimism","polygon"],"type":"string","description":"EVM chain (default base)"},"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Token contract"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"symbol":{"type":"string"},"decimals":{"type":["number","null"]},"total_supply":{"type":"string"},"total_supply_raw":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"chain":"base","token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","source":"eth_call totalSupply","symbol":"USDC","chain_id":8453,"decimals":6,"total_supply":"4324085953.222857","total_supply_raw":"4324085953222857"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UMqbl7PbKzvfqODgvHEHU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","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 ERC20 or ERC721 token on a given EVM chain, formatted with decimals and symbol, via eth_call totalSupply.","exampleAgentPrompt":"What is the total supply of the USDC token at contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base, with the symbol and decimal formatting?","exampleUseCases":[{"title":"DeFi token supply audit","prompt":"Can you check the total supply of the token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base and tell me the symbol and how many decimals it uses?"},{"title":"NFT collection size check","prompt":"How many NFTs have been minted in total for the ERC721 contract at 0x1234567890abcdef1234567890abcdef12345678 on Ethereum?"},{"title":"Cross-chain supply comparison","prompt":"What is the total supply of the token at 0xabcdef1234567890abcdef1234567890abcdef12 on Arbitrum — give me the formatted number and the raw amount."}],"resultDescription":"Returns a JSON object with the token's total supply as a human-readable formatted string (accounting for decimals), the raw integer supply, the token symbol, the number of decimals, the chain name, chain ID, and the source method (eth_call totalSupply).","failureModes":["Invalid or non-checksummed token contract address returns an error","Contract address does not implement totalSupply (not ERC20/ERC721) returns a call revert or null","Unsupported chain value returns a validation error","Network congestion or RPC timeout may cause delayed or failed eth_call","Token with no symbol or decimals set may return null for those fields"],"whenToPreferThis":"Use this endpoint when you need to quickly retrieve the on-chain total supply of any ERC20 or ERC721 token across Base, Ethereum, Arbitrum, Optimism, or Polygon without running your own node. It is ideal for DeFi research, token analytics, NFT collection audits, or any workflow that needs supply data formatted with the correct decimals and symbol in a single cheap call ($0.001).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T12:35:37.228Z","isFirstParty":false,"canonicalSlug":"erc20-erc721-total-supply-lookup-76112fc6"}