{"uid":"cap_-ECngYca-NB_VUzHVNPLe","slug":"x402-agent-hub-erc-20-token-metadata-9b510ccf","name":"x402 Agent Hub – ERC-20 Token Metadata","description":"ERC-20 token metadata on 7 EVM chains: name, symbol, decimals and formatted total supply in one call. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.","url":"https://x402-agent-hub.x402-agent-hub.workers.dev/v1/chain/token-info?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":{"type":"string","description":"base (default), ethereum, arbitrum, optimism, polygon, bsc or avalanche. Chain IDs also accepted."},"token":{"type":"string","description":"0x-prefixed ERC-20 token contract address."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"name":"USD Coin","chain":"base","token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","chainId":8453,"decimals":6,"totalSupply":{"raw":"4170000000000000","symbol":"USDC","decimals":6,"formatted":"4170000000"}}},"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_NNcFFcKCkpMPGAhZxKtCu","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":"Returns name, symbol, decimals, and formatted total supply for any ERC-20 token contract across 7 EVM chains in a single GET call.","exampleAgentPrompt":"What's the name, symbol, decimals, and total supply for the ERC-20 token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base?","exampleUseCases":[{"title":"Verify token details before DeFi trade","prompt":"Before I swap, can you pull the name, symbol, decimals and total supply for the token at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum so I know exactly what I'm dealing with?"},{"title":"Audit unfamiliar contract on Polygon","prompt":"I found this contract address 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174 on Polygon — can you look up its ERC-20 metadata like name, symbol, decimals and formatted total supply?"},{"title":"Cross-chain token supply comparison","prompt":"What's the total supply of USDC on Base versus Arbitrum? Look up the token info for each — Base address is 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 and Arbitrum address is 0xaf88d065e77c8cC2239327C5EDb3A432268e5831."}],"resultDescription":"A JSON object containing the token's canonical name, ticker symbol, number of decimals, the chain name and numeric chain ID, the contract address queried, and the total supply in both raw (integer) and human-formatted (decimal-adjusted) forms along with the symbol for convenience.","failureModes":["Invalid or non-checksummed token address returns an error and cancels payment settlement","Token address not found on the specified chain returns a not-found error with no charge","Unsupported chain name or chain ID returns a validation error","Upstream RPC or node failure cancels settlement with no charge","Missing required 'token' query parameter returns a 400-level error"],"whenToPreferThis":"Choose this endpoint when you need a single, cheap, multi-chain ERC-20 metadata lookup (name, symbol, decimals, total supply) without running your own RPC node or writing on-chain calls. It covers 7 major EVM chains in one unified API and only charges $0.002 USDC on successful reads, making it ideal for agents enriching token data, auditing unknown contracts, or populating UI metadata before a trade or transfer.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-14T12:34:51.543Z","isFirstParty":false,"canonicalSlug":"x402-agent-hub-erc-20-token-metadata-9b510ccf"}