{"uid":"cap_TxLNe4g1vdtu-wdlL_5Yg","slug":"eth-mainnet-erc-20-total-supply-d9b9ba4c","name":"ETH Mainnet ERC-20 Total Supply","description":"Total supply of an ERC-20 token contract on Ethereum via totalSupply given token address. Base ERC-20 read of token contract address.","url":"https://ari001.tailb4ac3a.ts.net/v1/ventures/x402_eth_reads_v1/eth_mainnet_erc20_totalsupply?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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"ERC-20 contract, 0x + 40 hex"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["ok","service"],"properties":{"ok":{"type":"boolean"},"chain":{"type":"string"},"error":{"type":"string","description":"present when ok is false"},"method":{"type":"string"},"result":{"type":"string","description":"the uint256 as a decimal string"},"service":{"type":"string"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VsChE4Xii0-8vfmR4k16N","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","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 ERC-20 token contract on Ethereum Mainnet by calling totalSupply on the given token address.","exampleAgentPrompt":"What's the total supply of the ERC-20 token at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum mainnet?","exampleUseCases":[{"title":"Token supply check for DeFi analysis","prompt":"Can you look up the total supply of the USDC token contract at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum mainnet?"},{"title":"Monitoring token inflation over time","prompt":"I want to track token inflation — can you fetch the current total supply for the token at 0x6B175474E89094C44Da98b954EedeAC495271d0F on Ethereum mainnet so I can compare it to last week's number?"},{"title":"Verifying token contract details before investing","prompt":"Before I invest, can you tell me the total supply of the token contract 0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599 on Ethereum mainnet so I know how many tokens exist?"}],"resultDescription":"Returns the total supply value from the ERC-20 contract's totalSupply() function on Ethereum Mainnet, representing the total number of tokens that have been minted (minus burned), typically as a large integer in the token's base units.","failureModes":["Invalid token address format (must be 0x + 40 hex characters) returns a validation error","Contract address is not an ERC-20 token (lacks totalSupply function) results in a contract call failure","Network connectivity issues to Ethereum mainnet RPC may cause timeouts","Non-existent or zero-address contracts may return zero or an error","Payment failure ($0.003 USDC) prevents the request from being processed"],"whenToPreferThis":"Use this endpoint when you need the on-chain total supply of an ERC-20 token on Ethereum Mainnet specifically. Prefer this over alternative endpoints when you want a direct, low-latency blockchain read without additional AI interpretation or bundled data. This is ideal for agents performing tokenomics analysis, monitoring supply changes, or verifying contract details on Ethereum mainnet (not Base or Gnosis — use sibling endpoints for those chains).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T06:49:40.518Z","isFirstParty":false,"canonicalSlug":"eth-mainnet-erc-20-total-supply-d9b9ba4c"}