{"uid":"cap_UI6onTQc6geqb5Qeb0Nas","slug":"blockscout-token-info-api-f3e36b85","name":"Blockscout Token Info API","description":"Access to api/v2/tokens/:address_hash. Retrieve detailed information about a specific token","url":"https://api.blockscout.com/:chain_id/api/v2/tokens/:address_hash_param","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","HEAD","DELETE"],"type":"string"},"pathParams":{"type":"object","properties":{"chain_id":{"type":"string"},"address_hash_param":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"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_iUOtt7YSNqFm5l0z4kYC0","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":"Retrieve detailed metadata and on-chain information about a specific ERC-20 or other token by its contract address on a given blockchain","exampleAgentPrompt":"Can you pull up the full token details for the contract at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum mainnet — I want to see the name, symbol, total supply, and decimals?","exampleUseCases":[{"title":"DeFi portfolio token identification","prompt":"I've got a token contract address 0x6B175474E89094C44Da98b954EedeAC495271d0F on Ethereum — can you tell me what token this is, its symbol, decimals, and total supply?"},{"title":"Token due diligence before swap","prompt":"Before I swap into this token, can you look up the contract 0x514910771AF9Ca656af840dff83E8264EcF986CA on Ethereum mainnet and give me its name, type, holder count, and any available exchange rate?"},{"title":"Multi-chain token metadata enrichment","prompt":"I'm building a report and need the full token info for contract address 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174 on Polygon — name, symbol, decimals, total supply, and logo URL if available."}],"resultDescription":"Returns a JSON object containing comprehensive token metadata including token name, symbol, token type (e.g. ERC-20, ERC-721), total supply, number of decimals, holder count, contract address, token logo URL, and exchange rate/price information where available.","failureModes":["Invalid or non-existent contract address returns 404 not found","Unsupported or invalid chain_id returns an error response","Contract address exists but is not a token contract — returns empty or error","Rate limiting may occur under high request volume","Token may exist but have no indexed metadata yet if recently deployed"],"whenToPreferThis":"Use this endpoint when you need authoritative on-chain token metadata for a specific contract address across multiple EVM-compatible chains. Prefer it over generic blockchain explorers when you need structured JSON data about a token (name, symbol, supply, decimals, holders) for programmatic use. Ideal when the contract address is known and you need to identify or verify what token it represents, especially on chains indexed by Blockscout (Ethereum, Polygon, Base, Gnosis, etc.).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:43:38.859Z","isFirstParty":false}