{"uid":"cap_bfz2MZu3gg6Q2JLWmhYjP","slug":"agent-data-tools-erc-20-token-info-lookup-0033d717","name":"Agent Data Tools: ERC-20 Token Info Lookup","description":"Look up the name, symbol, decimals and total supply of an ERC-20 token contract on Optimism, live from the contract. Use to identify an unknown token address or to format raw amounts; for a holder's balance use op_token_balance. Input is a ticker (USDC, WETH…) or the token's 0x contract address; an address that is not an ERC-20 contract returns 422, uncharged.","url":"https://agent-data-tools.revmesh2074.workers.dev/op/token-info?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["token"],"properties":{"token":{"type":"string","description":"Token: a ticker such as USDC or WETH, or the 0x ERC-20 contract address"}}},"responseSchema":{"type":"object","properties":{"name":{"type":"string"},"chain":{"type":"string"},"token":{"type":"string"},"symbol":{"type":"string"},"chainId":{"type":"number"},"decimals":{"type":"number"},"totalSupply":{"type":"string"},"totalSupplyRaw":{"type":"string"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USD","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_lPOKw0cZWjUHpab4rzl-9","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":"Returns metadata for an ERC-20 token contract including name, symbol, decimals, chain, and total supply","exampleAgentPrompt":"What's the name, symbol, decimals, and total supply for the ERC-20 token at contract address 0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85 on Optimism?","exampleUseCases":[{"title":"Resolve unknown token contract metadata","prompt":"I found this contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 in a transaction — can you tell me what token it is, what chain it's on, and how many decimals it uses?"},{"title":"Verify token supply before DeFi integration","prompt":"Before I integrate this ERC-20 at 0x6B175474E89094C44Da98b954EedeAC495271d0F into my app, can you pull its full token info — name, symbol, total supply, and decimals?"},{"title":"Enrich portfolio data with token metadata","prompt":"I have a list of ERC-20 contract addresses from my wallet transactions and I need the human-readable name and symbol for each one — start with 0x4200000000000000000000000000000000000042."}],"resultDescription":"A JSON object with the token's human-readable name, ticker symbol, chain name, chain ID, contract address, number of decimals, formatted total supply (e.g. '1000000000.0'), and raw total supply integer string.","failureModes":["Invalid or non-ERC-20 contract address returns an error","Contract address exists but is not a standard ERC-20 (e.g. ERC-721 NFT) may return incomplete data","Unsupported chain for the given contract address","Network timeout or RPC error from the underlying chain provider","Missing required 'token' query parameter returns validation error"],"whenToPreferThis":"Use this endpoint when you need canonical metadata (name, symbol, decimals, total supply) for a known ERC-20 contract address and do not need real-time price data. It is ideal for enriching transaction data, validating token contracts, or building UI labels for on-chain assets. Prefer this over price endpoints when metadata rather than market data is the goal.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:47:40.275Z","isFirstParty":false,"canonicalSlug":"agent-data-tools-erc-20-token-info-lookup-0033d717"}