{"uid":"cap_gu7XDFovhZrp5zsE2X3au","slug":"saylor-innovations-data-desk-erc-20-erc-721-total-supply-61296b0b","name":"Saylor Innovations Data Desk – ERC-20/ERC-721 Total Supply","description":"Total supply of an ERC-20 or ERC-721 contract on 16 EVM chains, raw and scaled by decimals, with symbol and name from totalSupply.","url":"https://saylorinnovations.com/api/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":["chain","token"],"properties":{"chain":{"type":"string","description":"chain name (ethereum, base, arbitrum, optimism, polygon, bsc, avalanche, gnosis, linea, scroll, mantle, blast, sonic, celo, berachain, unichain) or chain id"},"token":{"type":"string","description":"the token or NFT contract address"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","required":["chain","chain_id","token","total_supply_raw","source"],"properties":{"name":{"type":["string","null"],"description":"token name"},"note":{"type":"string","description":"how to read the supply"},"chain":{"type":"string","description":"the chain name that was queried"},"token":{"type":"string","description":"the token or NFT contract"},"source":{"type":"string","description":"where the data was read from"},"symbol":{"type":["string","null"],"description":"token symbol"},"chain_id":{"type":"number","description":"EIP-155 chain id of that network"},"decimals":{"type":["number","null"],"description":"token decimals, null for NFTs"},"total_supply":{"type":["string","null"],"description":"supply divided by 10^decimals, null when decimals are unknown"},"total_supply_raw":{"type":"string","description":"supply in the smallest unit"}}}}}}},"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_AQLkDRKK54461hxm84E5T","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 any ERC-20 token or ERC-721 NFT contract on 16 EVM chains, raw and decimal-scaled, with symbol, name, and decimals.","exampleAgentPrompt":"What's the total supply of USDC (contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) on Ethereum — give me both the raw amount and the human-readable number?","exampleUseCases":[{"title":"NFT collection mint count check","prompt":"How many NFTs have been minted so far in this collection? The contract address is 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D and it's on Ethereum."},{"title":"DeFi token supply monitoring","prompt":"What is the total supply of ARB token at contract 0x912CE59144191C1204E64559FE8253a0e49E6548 on Arbitrum, both raw and scaled by decimals?"},{"title":"Cross-chain supply comparison","prompt":"Can you look up the total supply of USDT on both Polygon and BSC? The contract on Polygon is 0xc2132D05D31c914a87C6611C10748AEb04B58e8F and on BSC it's 0x55d398326f99059fF775485246999027B3197955."}],"resultDescription":"A JSON object containing the chain name and chain ID, the token contract address, the raw total supply in smallest units (total_supply_raw), the decimal-scaled human-readable supply (total_supply), the token symbol, name, decimals (null for NFTs), and a source field indicating where the data was read from, plus a note explaining how to interpret the supply figures.","failureModes":["Invalid or unsupported chain name/ID returns an error","Contract address not found or not an ERC-20/ERC-721 on the specified chain","RPC node unavailability for a specific chain causing lookup failure","Decimals unknown for some tokens resulting in null total_supply (only raw returned)","Rate limiting or payment failure (x402) if USDC payment is not processed","Malformed contract address (non-checksummed or wrong length)"],"whenToPreferThis":"Use this endpoint when you need the total supply of any ERC-20 token or ERC-721 NFT collection on any of 16 supported EVM chains (Ethereum, Base, Arbitrum, Optimism, Polygon, BSC, Avalanche, Gnosis, Linea, Scroll, Mantle, Blast, Sonic, Celo, Berachain, Unichain). It is especially useful when you need both raw and decimal-normalized supply in a single call, or when you want the token's name and symbol resolved in the same request. Prefer this over general blockchain RPC calls when you want a clean, normalized JSON response without managing chain-specific RPC connections.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T00:39:08.532Z","isFirstParty":false,"canonicalSlug":"saylor-innovations-data-desk-erc-20-erc-721-total-supply-61296b0b"}