{"uid":"cap_eyHUdXp_qBcxCNb6f0FWm","slug":"erc-20-token-metadata-lookup-7d53e91d","name":"ERC-20 Token Metadata Lookup","description":"Paid x402 endpoints organized into product clusters. USDC-settled on Base. MCP-callable. ERC-8004 identity registry agentId 47167.","url":"https://x402.agentutility.ai/erc20-metadata","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":["token"],"properties":{"block":{"description":"'latest' default, or hex/decimal block number."},"chain":{"description":"Chain id or slug. 8453|'base' (default), 1|'ethereum', 42161|'arbitrum', 10|'optimism', 137|'polygon', 56|'bsc', 43114|'avalanche'."},"token":{"type":"string","description":"ERC-20 contract address (0x...)."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"name":{"type":"string"},"block":{"type":"string"},"chain":{"type":"string"},"token":{"type":"string"},"symbol":{"type":"string"},"chain_id":{"type":"integer"},"decimals":{"type":"integer"},"explorer_url":{"type":"string"},"total_supply":{"type":"string"},"total_supply_raw":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"name":"USD Coin","block":"latest","chain":"base","token":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","symbol":"USDC","chain_id":8453,"decimals":6,"explorer_url":"https://basescan.org/token/0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","total_supply":"5234567890.123456","total_supply_raw":"5234567890123456"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_sdJM6rrHS0TNrax95XiWE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns on-chain metadata for an ERC-20 token (name, symbol, decimals, total supply, explorer URL) given a contract address and chain.","exampleAgentPrompt":"What are the name, symbol, decimals, and total supply for the ERC-20 token at contract address 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 on the Base chain (chain ID 8453)?","exampleUseCases":null,"resultDescription":"A JSON object containing the token's human-readable name, ticker symbol, number of decimals, chain name, chain ID, contract address, total supply as a formatted decimal string, total supply as a raw integer string, and a block explorer URL pointing to the token on Basescan or equivalent.","failureModes":["Invalid or non-ERC-20 contract address returns an error or empty fields","Unsupported chain identifier causes a rejection or unknown chain error","Payment not settled (x402 underpayment) results in 402 Payment Required","Node RPC timeout causes a delayed or failed response","Token with non-standard metadata (e.g. missing name/symbol) may return partial data"],"whenToPreferThis":"Use this endpoint when you need authoritative on-chain ERC-20 token metadata — name, symbol, decimals, total supply — without querying a centralized token list. Prefer it over CoinGecko or CoinMarketCap when you need raw contract-level data (especially decimals and raw total supply) for a specific chain like Base, or when integrating into an x402/USDC agent payment pipeline.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T13:13:23.622Z","isFirstParty":false}