{"uid":"cap_pCWYbp17nmlpeW79_ahwD","slug":"erc-20-token-on-chain-metadata-reader-189b27de","name":"ERC-20 Token On-Chain Metadata Reader","description":"ERC-20 token metadata read on-chain: name, symbol, decimals, total supply (public RPC). 0.01 USDC/call on Base.","url":"https://task-radar-x402.vercel.app/api/erc20?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":{"const":"http"},"method":{"const":"GET"},"queryParams":{"type":"object","properties":{"chain":{"type":"string","description":"ethereum|base|arbitrum|optimism|polygon|bsc (default ethereum)"},"address":{"type":"string","description":"Token address"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_gyClDTEFQn6MDeflEVfpc","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Reads ERC-20 token metadata (name, symbol, decimals, total supply) directly from on-chain public RPC nodes across multiple EVM chains.","exampleAgentPrompt":"What are the name, symbol, decimals, and total supply of the ERC-20 token at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum?","exampleUseCases":[{"title":"Identify unknown token contract","prompt":"I found this contract address 0x6B175474E89094C44Da98b954EedeAC495271d0F on Ethereum — can you tell me what ERC-20 token it is, its symbol, and how many decimals it uses?"},{"title":"Verify token supply before investment","prompt":"What is the total supply of the token at 0x4d224452801ACEd8B2F0aebE155379bb5D594381 on Ethereum? I want to know if it matches what the project claims."},{"title":"DeFi app token metadata lookup","prompt":"Pull the on-chain name, symbol, and decimals for contract 0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d on BSC — I need this to display it correctly in my portfolio tracker."}],"resultDescription":"Returns the ERC-20 token's on-chain metadata including: human-readable name (e.g. 'USD Coin'), ticker symbol (e.g. 'USDC'), decimals (e.g. 6), and total supply (as a raw integer from the contract). Data is fetched live from the chain's public RPC node.","failureModes":["Invalid or non-ERC-20 contract address returns an error or empty fields","Unsupported chain name returns a validation error","Contract not deployed on specified chain returns null or RPC error","RPC node temporarily unavailable causes timeout or 5xx error","Address is a non-standard token that doesn't implement standard ERC-20 interface methods"],"whenToPreferThis":"Use this endpoint when you need authoritative, on-chain ERC-20 metadata directly from the blockchain rather than a centralized data provider. Prefer this over CoinGecko or CoinMarketCap when you have a contract address but no ticker, when you need decimals for precise token math, when verifying total supply against claimed figures, or when the token is too new or obscure to appear in off-chain databases. Supports Ethereum, Base, Arbitrum, Optimism, Polygon, and BSC.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:40:22.098Z","isFirstParty":false,"canonicalSlug":"erc-20-token-on-chain-metadata-reader-189b27de"}