{"slug":"agent402-tools-api-chain-total-supply-ab0715","title":"The circulating total supply of an ERC-20, read from the token contract itself r","host":"agent402.tools","method":"GET","resource":"https://agent402.tools/api/chain/total-supply","category":"market","description":"The circulating total supply of an ERC-20, read from the token contract itself rather than from an aggregator, so it is the number the chain holds at the block you asked for. Returns the raw uint256 and the same figure formatted with the token's own decimals. A contract that does not implement total","price_listed":0.001,"price_asked":0.001,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":923,"reported_calls_30d":1,"reported_payers_30d":1,"networks":["algorand:wGHE2Pwdvd7S12BL5FaOP20EGYesN73ktiC1qzkkit8=","eip155:10","eip155:1329","eip155:137","eip155:143","eip155:42161","eip155:42220","eip155:43114","eip155:4663","eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","stellar:pubnet"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"method":"GET","queryParams":{"contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","network":"base"},"type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"method":{"enum":["GET"],"type":"string"},"queryParams":{"properties":{"contract":{"description":"0x ERC-20 token contract address","type":"string"},"network":{"description":"ethereum | base | polygon | arbitrum | optimism (default base)","type":"string"}},"required":["contract"],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"properties":{"contract":{"type":"string"},"decimals":{"type":"integer"},"network":{"type":"string"},"totalSupply":{"type":"string"},"totalSupplyFormatted":{"type":"string"}},"required":["contract","network","totalSupply","decimals","totalSupplyFormatted"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-09-24","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.001,"price_match":true,"latency_ms":923,"error":null}],"description_full":"The circulating total supply of an ERC-20, read from the token contract itself rather than from an aggregator, so it is the number the chain holds at the block you asked for. Returns the raw uint256 and the same figure formatted with the token's own decimals. A contract that does not implement totalSupply answers 422 rather than a fabricated zero. EVM chains: ethereum, base, polygon, arbitrum, optimism.","last_updated":"2026-09-13T22:39:46.115Z","schemes":["exact","upto"]}