{"uid":"cap_CSQ9eczP-gqkcisv10v1X","slug":"blockscout-token-counters-by-chain-d3695ca9","name":"Blockscout Token Counters by Chain","description":"Explore crypto activities with Blockscout's multichain search. Find transactions, addresses, tokens, and dapps across top blockchain networks — your go-to explorer for cross-chain blockchain data","url":"https://api.blockscout.com/%7Bchain_id%7D/api/v2/tokens/%7Baddress_hash_param%7D/counters","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":{"type":"json","example":{"transfers_count":"string","token_holders_count":"string"}},"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_zfFi8VR4-Tt-7v_81nXRP","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":"Returns transfer count and holder count statistics for a specific token contract on a given blockchain network","exampleAgentPrompt":"How many holders and total transfers does the USDC token contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 have on Ethereum mainnet? Use Blockscout to look it up.","exampleUseCases":[{"title":"Token adoption research for DeFi analyst","prompt":"Can you check how many unique holders and total transfers the token at 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 has on Ethereum? I want to gauge how widely adopted it is."},{"title":"Monitor new token traction on L2","prompt":"Look up the holder count and transfer count for the token contract 0x4200000000000000000000000000000000000042 on Optimism — I'm trying to see if it's gaining traction."},{"title":"Cross-chain token comparison","prompt":"Fetch the number of holders and transfers for the token 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174 on Polygon using Blockscout so I can compare it to its Ethereum counterpart."}],"resultDescription":"Returns a JSON object with two string fields: transfers_count (total number of token transfer events recorded on-chain for that contract) and token_holders_count (total number of unique addresses currently holding a non-zero balance of the token), both as stringified integers.","failureModes":["Invalid or non-existent token contract address returns empty or error response","Unsupported chain_id returns 404 or no data","Token contract exists but has no recorded transfers yet — counters may return zero strings","Network latency or Blockscout node downtime causes timeout","Malformed address hash (wrong length or checksum) returns validation error"],"whenToPreferThis":"Choose this endpoint when you need lightweight, fast token adoption statistics (holder count and transfer count) for a specific contract on a specific chain without requiring full transfer history or holder list. It is more efficient than fetching paginated holder lists or transfer lists when only aggregate counts are needed. Best for dashboards, quick comparisons, or eligibility checks where raw totals suffice.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-12T12:41:00.921Z","isFirstParty":false}