# Blockscout Token Transfers CSV Export

> Blockscout Token Transfers CSV Export is a paid API for AI agents from api.blockscout.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Exports a CSV file of token transfer history for a specific token contract address on a given blockchain network, filtered by date range

## Facts

- Endpoint: GET https://api.blockscout.com/%7Bchain_id%7D/api/v2/tokens/%7Baddress_hash_param%7D/transfers/csv
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockscout-token-transfers-csv-export-0e6a4705
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_t12DVCwMlFGN2kzf9FOdC

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability blockscout-token-transfers-csv-export-0e6a4705
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockscout-token-transfers-csv-export-0e6a4705/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.blockscout.com](https://www.zero.xyz/host/api.blockscout.com/llms.txt)