{"uid":"cap_ASLEE3oulO2wKD47CGMe6","slug":"blockscout-token-holders-csv-export-ea38a9bb","name":"Blockscout Token Holders CSV Export","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/holders/csv","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"}}},"queryParams":{"type":"object","properties":{"to_period":{"type":"string"},"filter_type":{"type":"string"},"from_period":{"type":"string"},"filter_value":{"type":"string"}}}},"additionalProperties":false}}},"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_06A5NmNgYdtxrCpXrsQHh","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":"Exports a CSV file listing all addresses holding a specific token on a given blockchain, with optional period and filter parameters","exampleAgentPrompt":"Can you download the full CSV list of all holders for the USDC token at address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum (chain ID 1) from Blockscout?","exampleUseCases":[{"title":"Airdrop recipient list generation","prompt":"I need to export a CSV of every wallet holding the governance token at 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 on Ethereum mainnet — I want to use it for an airdrop snapshot."},{"title":"Token distribution analysis","prompt":"Can you pull the full holder list for the token at 0x7Fc66500c84A76Ad7e9c93437bFc5Ac33E2DDaE9 on chain 137 (Polygon) as a CSV so I can analyze how concentrated the token distribution is?"},{"title":"Filtered holder snapshot by time period","prompt":"Get me a CSV export of holders for the token contract 0x6B175474E89094C44Da98b954EedeAC495271d0F on chain 1, filtered from January to March 2024, so I can see who was holding DAI during that period."}],"resultDescription":"A CSV file download containing a ranked list of token holder addresses along with their balances and share of total supply. The file includes columns for address, balance, and percentage held, and can be filtered by time period and custom filter criteria.","failureModes":["Invalid chain_id returns 404 or empty response","Invalid or non-existent token contract address returns error or empty CSV","Unsupported filter_type value may return unfiltered results or error","Very large holder sets may result in truncated CSV or timeout","Malformed date strings in from_period/to_period may cause 400 bad request"],"whenToPreferThis":"Use this endpoint when you need a bulk, downloadable export of all token holders in CSV format for offline analysis, airdrop distribution, or reporting — particularly when you need to process the data in spreadsheet tools or data pipelines. Prefer it over the paginated holders endpoint when you need the full list at once rather than page-by-page JSON results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-10T00:42:02.801Z","isFirstParty":false}