{"uid":"cap_7mNGHG3bhQlKfSczHiFbf","slug":"erc-20-token-info-lookup-by-chain-cbe98564","name":"ERC-20 Token Info Lookup by Chain","description":"Generate an AI_POLICY.md and a pull request template with an AI-disclosure section for your open-source repo. Free, runs in your browser.","url":"https://ai-policy-kit.moneymaker-ai.workers.dev/api/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":["chain","token"],"properties":{"chain":{"enum":["base","ethereum","bsc","arbitrum","optimism","polygon","gnosis","celo"],"type":"string"},"token":{"type":"string","description":"0x token contract address"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"name":"USD Coin","block":52783453,"chain":"base","owner":"0x3ABd6f64A422225E61E435baE41db12096106df7","proxy":{"admin":"0x4fc7850364958d97B4d3f5A08f79db2493f8cA44","standard":"OpenZeppelin legacy (zos) slot","implementation":"0x2Ce6311ddAE708829bc0784C967b7d77D19FD779"},"token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","chainId":8453,"decimals":6,"code_bytes":1852,"total_supply":"4318565539.872118","total_supply_raw":"4318565539872118"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Llxj-t5GQPIfTUWyyhGHe","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns detailed metadata and on-chain statistics for an ERC-20 token contract address on a specified blockchain network","exampleAgentPrompt":"Can you look up the on-chain token info for USDC at contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — I want the name, symbol, decimals, total supply, and proxy details?","exampleUseCases":[{"title":"Verify token contract before DeFi interaction","prompt":"Before I swap, can you pull the on-chain metadata for the token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — confirm the name, symbol, decimals, and whether it's a proxy contract?"},{"title":"Compare total supply across chains","prompt":"What is the total supply of the token at contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum — give me the raw and formatted number, plus the current block?"},{"title":"Audit proxy admin and implementation address","prompt":"I need to audit the proxy setup for the token contract 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174 on Polygon — who is the proxy admin and what is the current implementation address?"}],"resultDescription":"A JSON object containing the token's name, symbol, decimals, chain ID, current block number, contract address, owner address, raw and formatted total supply, contract bytecode size, and full proxy details (admin address, implementation address, and proxy standard) if applicable.","failureModes":["Invalid or non-ERC-20 contract address returns an error or empty result","Unsupported chain value returns a validation error","Malformed 0x address format causes a 400-level error","Contract with no proxy returns null proxy fields","RPC node unavailability for the target chain causes a timeout or 500 error"],"whenToPreferThis":"Use this endpoint when you need fast, structured on-chain metadata for a known ERC-20 token contract across major EVM-compatible chains, especially when you need proxy contract details, total supply, or owner information without running your own RPC node. Prefer this over manual RPC calls or block explorers when you need machine-readable JSON output for downstream automation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T12:34:32.880Z","isFirstParty":false,"canonicalSlug":"erc-20-token-info-lookup-by-chain-cbe98564"}