{"uid":"cap_t12DVCwMlFGN2kzf9FOdC","slug":"blockscout-token-transfers-csv-export-0e6a4705","name":"Blockscout Token Transfers 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/transfers/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","required":["from_period","to_period"],"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_EhuXoqFP-SaZrseK3G9Nr","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 of token transfer history for a specific token contract address on a given blockchain network, filtered by date range","exampleAgentPrompt":"Can you download a CSV of all transfers for the USDC token contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum from January 1 2024 to March 31 2024 using Blockscout?","exampleUseCases":[{"title":"Tax season token transfer export","prompt":"I need a CSV of all transfers for the token at 0x6B175474E89094C44Da98b954EedeAC495271d0F on Ethereum between January 1 2024 and December 31 2024 so I can give it to my accountant — can you pull that from Blockscout?"},{"title":"DeFi protocol treasury audit","prompt":"Pull the full CSV export of token transfers for contract 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 on Ethereum from July 1 2024 to September 30 2024 from Blockscout — I need to audit all inflows and outflows."},{"title":"Cross-chain token activity reconciliation","prompt":"Get me a CSV of all token transfers for address 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 on the Polygon chain between March 1 2024 and March 31 2024 from Blockscout so I can reconcile my portfolio."}],"resultDescription":"A downloadable CSV file containing token transfer records for the specified token contract address and chain, within the requested date range. Each row typically includes the transaction hash, block number, timestamp, sender address, receiver address, token amount, and token metadata. Optional filters can narrow results by address or other criteria.","failureModes":["Invalid or unrecognized chain_id returns 404 or empty response","Invalid token contract address format returns 400 bad request","Missing required from_period or to_period query parameters returns validation error","Date range too large may result in timeout or truncated results","Token contract not indexed on the specified chain returns empty CSV","Malformed filter_value with incompatible filter_type causes error","Rate limiting or payment failure ($0.002 USDC per call) results in 402 response"],"whenToPreferThis":"Use this endpoint when you need bulk historical token transfer data in a portable, spreadsheet-friendly CSV format for a specific token contract on a specific blockchain, especially for accounting, tax reporting, or audit purposes. Prefer this over JSON transfer endpoints when the consumer is a spreadsheet tool or human analyst. Prefer this over generic multichain search when you need a complete date-ranged export rather than paginated lookup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:43:45.140Z","isFirstParty":false}