{"uid":"cap_xHmUJcPxmVntWT1RS95RB","slug":"erc-20-total-supply-lookup-ethereum-mainnet-0c16eee5","name":"ERC-20 Total Supply Lookup (Ethereum Mainnet)","description":"Call when an agent needs ERC-20 totalSupply for one Ethereum mainnet token, raw and human when decimals() is readable. Send token. Read-only eth_call on eip155:1. No spend. Send JSON {\"token\":\"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48\"}. Exact $0.001 USDC on Base. Try unpaid POST /v1/sandbox/eth-total-supply first.","url":"https://agentshelf.syntexa.ch/v1/eth-total-supply?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"token":{"type":"string","examples":["0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"],"description":"ERC-20 contract on Ethereum mainnet. Example: 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48. Returns total_supply_raw and a human total_supply when decimals() is readable. Read-only."}}},"responseSchema":null,"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_Yob51htYKiLuxLrVS4bV_","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 raw and human-readable totalSupply of any ERC-20 token contract on Ethereum mainnet via a read-only eth_call.","exampleAgentPrompt":"What is the total supply of USDC on Ethereum mainnet? The contract address is 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 — give me both the raw number and the human-readable amount.","exampleUseCases":[{"title":"Check USDC circulating supply","prompt":"Look up the total supply of USDC on Ethereum mainnet — contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 — and show me both the raw integer and the formatted amount with decimals applied."},{"title":"Verify DAI token issuance","prompt":"Can you fetch the on-chain totalSupply for DAI (0x6B175474E89094C44Da98b954EedeAC495271d0F) on Ethereum and tell me how many DAI tokens currently exist in human-readable form?"},{"title":"Monitor WETH supply for DeFi dashboard","prompt":"Get the current total supply of Wrapped Ether (WETH, contract 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2) on Ethereum mainnet so I can display it on my DeFi analytics dashboard."}],"resultDescription":"Returns a JSON object containing total_supply_raw (the integer value directly from the contract's totalSupply() call) and total_supply (the human-readable value scaled by decimals() if that function is readable on the contract).","failureModes":["Invalid or non-ERC-20 contract address returns an error or empty result","Contract does not implement decimals() — raw supply is returned but human-readable value may be absent","Non-mainnet addresses (e.g. testnets or L2s) will not resolve correctly","Malformed address format (not a valid checksummed Ethereum address) returns a validation error","Payment failure on Base for the $0.001 USDC fee blocks the request"],"whenToPreferThis":"Choose this endpoint when you need a fast, read-only on-chain totalSupply lookup for a single ERC-20 token on Ethereum mainnet and want both raw and decimal-adjusted values in one call. Prefer it over general RPC providers when you want a simple REST interface without managing JSON-RPC directly, and over block explorer APIs when you need guaranteed freshness via direct eth_call rather than indexed data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T19:05:40.861Z","isFirstParty":false,"canonicalSlug":"erc-20-total-supply-lookup-ethereum-mainnet-0c16eee5"}