{"uid":"cap_d5pi0vXmYeXSeE3ItbUug","slug":"chainread-erc-20-metadata-lookup-51e88a9e","name":"ChainRead ERC-20 Metadata Lookup","description":"Cheap EVM read utilities for AI agents on Base and Ethereum mainnet: gas and fees, blocks, balances, ERC-20 metadata, contract inspection, transaction status, ENS/Basename resolution, bulk balances. No API key: pay USDC on Base per call via x402.","url":"https://chainread.imac2014ville.workers.dev/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":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["token"],"properties":{"chain":{"enum":["base","ethereum"],"type":"string","description":"Chain to read (default base)"},"token":{"type":"string","description":"ERC-20 contract address (0x…)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"name":"USD Coin","chain":"base","token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","isProxy":true,"decimals":6,"proxyKind":"EIP-1967","totalSupply":"4100000000","implementation":"0x2ce6311ddae708829bc0784c967b7d77d19fd779"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BeDxWWtLNc4yzDaotZEF0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches ERC-20 token metadata (name, symbol, decimals, total supply, proxy info) for a given contract address on Base or Ethereum mainnet","exampleAgentPrompt":"What's the name, symbol, decimals, and total supply for the ERC-20 contract at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — and is it a proxy contract?","exampleUseCases":[{"title":"Token display info for a DeFi dashboard","prompt":"I need the name, symbol, and decimals for the token at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum mainnet so I can display it correctly in my app."},{"title":"Proxy contract inspection for a smart contract audit","prompt":"Can you check if the ERC-20 contract at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base is a proxy, and if so, what kind of proxy pattern it uses and what the underlying implementation address is?"},{"title":"Total supply check for a new token","prompt":"What's the total supply of the ERC-20 token at 0x4200000000000000000000000000000000000006 on Base mainnet?"}],"resultDescription":"Returns a JSON object with ok status, token name, symbol, decimals, total supply (as a string), chain, token address, whether it is a proxy contract, proxy kind (e.g. EIP-1967), and the implementation contract address if applicable.","failureModes":["Invalid or non-ERC-20 contract address returns an error or unexpected data","Unsupported chain value (only 'base' and 'ethereum' are valid) results in an error","Contract address not found on the specified chain","Network/RPC timeouts causing delayed or failed responses","Missing required 'token' query parameter returns a validation error"],"whenToPreferThis":"Use this endpoint when you need lightweight, low-cost ERC-20 token metadata (name, symbol, decimals, total supply, proxy info) on Base or Ethereum mainnet without managing your own RPC node or API keys. It is ideal for AI agents that need to enrich token data on-the-fly, paying micro-amounts per call via USDC on Base (x402). Prefer this over full node queries or heavier blockchain indexers when you only need standard ERC-20 contract metadata and want minimal setup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:33:50.332Z","isFirstParty":false,"canonicalSlug":"chainread-erc-20-metadata-lookup-51e88a9e"}