{"uid":"cap_cotkpHBtzn4G7qMUtWpWk","slug":"erc-20-token-info-risk-api-x402-0f7e9900","name":"ERC-20 Token Info & Risk API (x402)","description":"Invoice-to-JSON, on-chain tools (transaction explainer + payment check, wallet profile, contract ABI, ERC-20 token risk), company contacts and web-to-RAG for AI agents. Pay per call with x402 (USDC on Base). No signup, no API key.","url":"https://freetier-agent-api.pages.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":["address"],"properties":{"chain":{"enum":["base","ethereum","arbitrum","optimism","polygon"],"type":"string","description":"default base"},"price":{"enum":["true","false"],"type":"string","description":"false skips the USD price"},"address":{"type":"string","description":"ERC-20 contract address, or comma list of up to 10"}}}}},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"at":{"type":["string","null"]},"rpc":{"type":["string","null"]},"chain":{"type":["string","null"]},"count":{"type":["number","null"]},"method":{"type":["string","null"]},"tokens":{"type":"array","items":{"type":["object","null"]}},"sources":{"type":"array","items":{"type":["object","null"]}}}}}}}},"responseSchema":{"type":"json","example":{"chain":"base","count":1,"tokens":[{"name":"USD Coin","chain":"base","symbol":"USDC","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","fdv_usd":4289131687,"decimals":6,"is_erc20":true,"price_usd":0.9996,"price_time":"2026-10-25T19:57:01.000Z","is_contract":true,"total_supply":"4290862904.934007","price_confidence":0.99,"total_supply_raw":"4290862904934007"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0025","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.0025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_q4oxrhUtlWHM31GLwKH0h","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches on-chain ERC-20 token metadata, risk indicators, USD price, and supply data for up to 10 contract addresses across major EVM chains, paid per call via x402 (USDC on Base).","exampleAgentPrompt":"Can you look up the token info for the contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base, including its current USD price?","exampleUseCases":[{"title":"Token legitimacy check before swap","prompt":"Before I swap into this token, can you check if the contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum is a real ERC-20, and what its current USD price and total supply are?"},{"title":"Multi-token portfolio enrichment","prompt":"I have these three Base token addresses — 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, 0x4200000000000000000000000000000000000006, 0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb — can you fetch their names, symbols, decimals, and USD prices all at once?"},{"title":"DeFi risk screening on Arbitrum","prompt":"Pull the on-chain risk profile for contract 0xFF970A61A04b1cA14834A43f5dE4533eBDDB5CC8 on Arbitrum — I want to know if it's a verified ERC-20, its price confidence score, and its fully diluted valuation."}],"resultDescription":"Returns a JSON object containing the chain queried, a count of tokens found, and an array of token objects each with: name, symbol, address, chain, decimals, is_erc20, is_contract, price_usd, price_time, price_confidence, fdv_usd, total_supply, and total_supply_raw. If price=false is passed, USD price fields are omitted.","failureModes":["Invalid or non-existent contract address returns empty tokens array or null fields","Unsupported chain value returns validation error","More than 10 addresses in a comma list may be rejected or truncated","Payment failure via x402 (insufficient USDC balance or wrong network) blocks the call","Token exists on-chain but is not ERC-20 compliant — is_erc20 returns false","Price data unavailable for obscure tokens — price_usd and price_confidence may be null","Network RPC outage may cause delayed or failed response"],"whenToPreferThis":"Choose this endpoint when you need fast, structured ERC-20 token metadata — including price, supply, and contract verification — across Base, Ethereum, Arbitrum, Optimism, or Polygon, without signing up for an API key. It supports batch lookups of up to 10 addresses per call and uses x402 micropayments (USDC on Base) making it ideal for agent workflows that need frictionless per-call billing. Prefer it over general blockchain explorers when you specifically need JSON-structured token data ready for downstream agent processing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:05:29.648Z","isFirstParty":false,"canonicalSlug":"erc-20-token-info-risk-api-x402-0f7e9900"}