{"uid":"cap_SmX6siRT8ENOPRpD9Obyq","slug":"evm-token-info-and-total-supply-ec85a439","name":"EVM Token Info and Total Supply","description":"Token info and total supply for any ERC20 on Ethereum, Base, Arc or BNB Chain: name, symbol, decimals and total supply (raw and in token units), read at a named block. A contract that is not an ERC20 is refused before any charge.","url":"https://apexfaucet.xyz/api/x402/evm-token-info?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","queryParams"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["token"],"properties":{"chain":{"enum":["ethereum","base","arc","bnb"],"type":"string","description":"Chain to read: ethereum, base, arc or bnb. Default ethereum."},"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"ERC20 token contract."}}}}},"output":{"type":"object"}}},"responseSchema":{"type":"json","schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"object"},"paid":{"type":"number"}}},"example":{"ok":true,"data":{"ok":true,"name":"USD Coin","block":52560086,"chain":"base","token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","decimals":6,"blockTime":"2026-10-13T16:38:39.000Z","totalSupply":"4403027971.940867","totalSupplyRaw":"4403027971940867"},"paid":0.001}},"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_CXFamDbMoeeRP5q3A2tS_","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 metadata and total supply for an ERC20 token on Ethereum, Base, Arc, or BNB Chain","exampleAgentPrompt":"What's the name, symbol, decimals, and total supply of the token at contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base?","exampleUseCases":[{"title":"Verify token identity before swap","prompt":"Before I swap, can you check the name, symbol, and decimals of the token at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum so I know it's actually USDC?"},{"title":"Track circulating supply of a DeFi token","prompt":"What's the current total supply of the token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base? I want to track how many tokens are in circulation."},{"title":"Enrich token screener with on-chain metadata","prompt":"Pull the token name, symbol, decimals, and total supply for contract 0x1234567890abcdef1234567890abcdef12345678 on BNB so I can add it to my token screener."}],"resultDescription":"Returns a JSON object with ok status, and a data object containing the token name, symbol, decimals, total supply (as a human-readable string), total supply as a raw integer, the block number at which the data was read, the block timestamp, and the chain and contract address queried. Also includes the amount paid in USDC for the call.","failureModes":["Invalid or non-ERC20 contract address returns an error or empty data","Unsupported chain value results in a validation error","Token contract exists but has no standard name/symbol/decimals (non-standard ERC20) may return partial data","Payment of 0.001 USDC not provided results in 402 Payment Required","Network latency or RPC issues on the target chain may cause timeouts"],"whenToPreferThis":"Choose this endpoint when you need on-chain ERC20 token metadata (name, symbol, decimals, total supply) directly from the blockchain across Ethereum, Base, Arc, or BNB Chain. It is ideal for DeFi agents that need to verify a token's identity before executing a trade, for token screeners that need to enrich contract addresses with metadata, or for any workflow that requires authoritative on-chain supply figures rather than cached off-chain data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:31:22.729Z","isFirstParty":false,"canonicalSlug":"evm-token-info-and-total-supply-ec85a439"}