{"uid":"cap_9bCHvCaURi4EakQvz1yA-","slug":"xerxes-erc20-total-supply-0195c185","name":"Xerxes ERC20 Total Supply","description":"Returns the total supply of an ERC20 token contract on Ethereum mainnet, as a decimal string. Query: token (ERC-20 contract, 0x + 40 hex).","url":"https://ari001.tailb4ac3a.ts.net/v1/ventures/ethereum_rpc_api/erc20_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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["token"],"properties":{"token":{"type":"string","pattern":"^0x[a-fA-F0-9]{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_cqb2v7DmG3D0zz6Qw2sWW","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 a given ERC-20 token contract on Ethereum mainnet as a decimal string.","exampleAgentPrompt":"What's the total supply of the USDC token on Ethereum mainnet? The contract address is 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48.","exampleUseCases":[{"title":"Check DeFi governance token supply","prompt":"What's the total supply of the Uniswap governance token on Ethereum? The contract address is 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984."},{"title":"Monitor stablecoin issuance","prompt":"How many USDT tokens have been issued on Ethereum mainnet? Contract address is 0xdAC17F958D2ee523a2206206994597C13D831ec7."},{"title":"Verify token supply for due diligence","prompt":"I'm evaluating a token project — can you tell me the total supply for the ERC-20 contract at 0x6B175474E89094C44Da98b954EedeAC495271d0F on Ethereum?"}],"resultDescription":"Returns a JSON object with an 'ok' boolean, a 'result' field containing the uint256 total supply as a decimal string, the chain name, the method called, and the service name. On failure, includes an 'error' field describing what went wrong.","failureModes":["Invalid contract address format (not matching 0x + 40 hex) — validation error returned","Contract address is not an ERC-20 contract — may return zero or error","Ethereum mainnet RPC unavailable — service-level error returned with ok: false","Address is a valid hex but non-existent or non-contract account — returns zero or error","Network congestion or timeout from the underlying RPC node"],"whenToPreferThis":"Use this endpoint when you need the on-chain totalSupply() value for a specific ERC-20 contract on Ethereum mainnet. It is ideal for agents that need token supply data for DeFi analysis, tokenomics research, or due diligence without setting up their own Ethereum node or RPC provider. Prefer this over generic blockchain explorers when you want a machine-readable decimal string response suitable for downstream computation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T01:23:18.784Z","isFirstParty":false,"canonicalSlug":"xerxes-erc20-total-supply-0195c185"}