{"uid":"cap_2QC-hN-krOmQRdvCdFZ4F","slug":"erc-20-token-metadata-lookup-2f58d84a","name":"ERC-20 Token Metadata Lookup","description":"Machine-payable data APIs for AI agents across web search, on-chain reads, trading data, market judgment, and AI visibility. The canonical x402 catalog currently exposes 85 paid routes. Pay per call in USDC via x402 on Base. No API keys, no signup.","url":"https://store.agentexchange.work/chain/token","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|ethereum|optimism|arbitrum|polygon|gnosis (default base)"},"token":{"type":"string","description":"ERC-20 contract address (0x...)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"name":{"type":"string"},"symbol":{"type":"string"},"decimals":{"type":"number"},"is_erc20":{"type":"boolean"},"total_supply":{"type":"number"}}}}}}},"responseSchema":{"type":"json","example":{"name":"USD Coin","chain":"base","token":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","symbol":"USDC","decimals":6,"is_erc20":true,"warnings":[],"is_contract":true,"total_supply":4172781685.50414,"decimals_assumed":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.09","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.09/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.09","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.09","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_TFIE9akEKeLeadAu5CFKN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.09","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns on-chain metadata for an ERC-20 token contract — name, symbol, decimals, total supply, and verification flags — across major EVM chains.","exampleAgentPrompt":"Look up the token metadata for the contract 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 on Base — I need the name, symbol, decimals, and total supply.","exampleUseCases":[{"title":"Token identity check before trade","prompt":"Before I swap into this token, can you confirm the name, symbol, and decimals for the contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum? I want to make sure it's the real USDC and not a fake."},{"title":"Decoding raw transfer amounts","prompt":"I'm seeing a raw transfer value of 1000000 for the token at 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 on Base — can you fetch the decimals so I can work out the actual human-readable amount?"},{"title":"Auditing an unknown contract","prompt":"Someone sent me tokens from 0x4200000000000000000000000000000000000006 on Optimism — can you tell me what token this is, whether it's a legit ERC-20, and what its total supply is?"}],"resultDescription":"A JSON object containing the token's name, symbol, decimals, total supply (as a human-readable float), the chain it was queried on, whether the address is a deployed contract, whether it conforms to the ERC-20 standard, a flag indicating if decimals were assumed rather than read, and any warnings (e.g. unusual supply, non-standard decimals).","failureModes":["Address is not a deployed contract — is_contract returns false, is_erc20 returns false","Contract exists but does not implement ERC-20 interface — is_erc20 returns false with warnings","Invalid address format — likely a 4xx error or empty response","Unsupported chain identifier — request fails or defaults to Base","Payment not included or insufficient — 402 Payment Required response"],"whenToPreferThis":"Choose this endpoint when you need lightweight, fast ERC-20 token identity data (name, symbol, decimals, supply) from on-chain state without running a full node or integrating a heavyweight data provider. It's ideal for agents that need to resolve an unfamiliar contract address, validate token metadata before a transaction, or decode raw token amounts. Pay-per-call USDC pricing suits low-volume or sporadic lookups; the $29/month all-access key is better for high-frequency use. Prefer this over general blockchain explorers when you want a clean structured JSON response with no scraping or HTML parsing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:45:45.162Z","isFirstParty":false}