{"uid":"cap_77D3EgnP_AI8cW5Ym5a9C","slug":"erc-20-token-lookup-by-contract-address-16cc8388","name":"ERC-20 Token Lookup by Contract Address","description":"ERC-20 token lookup by contract address on base, ethereum, arbitrum, optimism, polygon, bsc: name, symbol, decimals, total supply, live USD price, fully diluted value, and whether the token is an upgradeable proxy (EIP-1967/EIP-1167, with implementation address).","url":"https://dt0ur.online/api/onchain/token?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"enum":["base","ethereum","arbitrum","optimism","polygon","bsc"],"type":"string","default":"base","description":"EVM chain: base, ethereum, arbitrum, optimism, polygon, bsc (default base)"},"token":{"type":"string","description":"Token contract address (0x...)"}}},"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_7LhNErL4-dhfbRzzckKtF","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":"Looks up ERC-20 token metadata and live market data (name, symbol, decimals, total supply, USD price, FDV, proxy status) by contract address across 6 EVM chains","exampleAgentPrompt":"Can you look up the ERC-20 token at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum — I need its name, symbol, decimals, current USD price, and whether it's an upgradeable proxy?","exampleUseCases":[{"title":"DeFi token due diligence check","prompt":"What token is deployed at 0x4200000000000000000000000000000000000006 on Base? Give me its name, symbol, total supply, current USD price, and whether the contract is an upgradeable proxy."},{"title":"Smart contract security audit","prompt":"I need to check if the token at 0xDA10009cBd5D07dd0CeCc66161FC93D7c9000da1 on Arbitrum is an EIP-1967 upgradeable proxy — and if so, what's the implementation address behind it?"},{"title":"Portfolio tracker enrichment","prompt":"I have a list of token contract addresses on Polygon and I need the name, symbol, decimals, and live USD price for the token at 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174 to enrich my portfolio data."}],"resultDescription":"Returns structured token metadata including: token name, symbol, number of decimals, total supply, live USD price, fully diluted valuation (FDV), a boolean indicating whether the contract is an upgradeable proxy (EIP-1967/EIP-1167), and the implementation contract address if applicable.","failureModes":["Invalid or non-existent contract address returns an error or empty result","Unsupported chain value outside the allowed enum causes a validation error","Contract address exists but is not an ERC-20 token may return partial or null metadata","Price data may be unavailable for very obscure or newly deployed tokens","Network congestion or RPC issues on the target chain may cause timeouts"],"whenToPreferThis":"Use this endpoint when you need on-chain ERC-20 token metadata combined with live market pricing in a single call across Base, Ethereum, Arbitrum, Optimism, Polygon, or BSC. Prefer it over generic blockchain explorers when you also need proxy detection (EIP-1967/EIP-1167) and implementation address resolution in one response. It complements the sibling wallet balance endpoint when you need token-level details rather than wallet-level holdings.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-03T00:47:55.748Z","isFirstParty":false,"canonicalSlug":"erc-20-token-lookup-by-contract-address-16cc8388"}