{"uid":"cap_cF5eD9jl9C_ldw7GBxyxJ","slug":"agent-data-tools-ethereum-token-info-b2d23e45","name":"Agent Data Tools: Ethereum Token Info","description":"Look up the name, symbol, decimals and total supply of an ERC-20 token contract on Ethereum, live from the contract. Use to identify an unknown token address or to format raw amounts; for a holder's balance use eth_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/eth/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_keTdOc4tXoMLV-5BZGg8E","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":"Retrieves ERC-20 token metadata (name, symbol, decimals, total supply, chain) for a given Ethereum contract address","exampleAgentPrompt":"What's the name, symbol, and total supply of the ERC-20 token at Ethereum contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48?","exampleUseCases":[{"title":"Identify unknown token contract","prompt":"I found this contract address 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 on Ethereum — can you tell me what token it is, its symbol, and how many decimals it uses?"},{"title":"Verify token supply before trade","prompt":"Before I make a trade, can you check the total supply of the token at 0xdAC17F958D2ee523a2206206994597C13D831ec7 on Ethereum so I know if it's a reasonable circulating amount?"},{"title":"Enrich DeFi portfolio with token metadata","prompt":"I have a list of ERC-20 contract addresses from my wallet — starting with 0x6B175474E89094C44Da98b954EedeAC495271d0F, look up its token name, symbol, and decimals so I can label it in my portfolio tracker."}],"resultDescription":"Returns a JSON object containing the token's full name, ticker symbol, chain name, chain ID, contract address, number of decimals, human-readable total supply, and raw total supply integer.","failureModes":["Invalid or non-ERC-20 contract address returns an error","Contract address on a non-supported chain may return no data","Malformed 0x address format causes a validation error","Payment failure (insufficient USDC balance) results in no charge and a 402 response"],"whenToPreferThis":"Use this endpoint when you need on-chain ERC-20 token metadata (name, symbol, decimals, supply) for a specific Ethereum contract address and want a pay-per-call model with no API key setup. Prefer it over general blockchain explorers when you need clean structured JSON output for agent consumption at minimal cost ($0.001 per call).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:47:55.852Z","isFirstParty":false,"canonicalSlug":"agent-data-tools-ethereum-token-info-b2d23e45"}