# Blockscout Address Token Transfers CSV Export

> Blockscout Address 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-11).

Exports a paginated CSV file of token transfer history for a specific blockchain address on a given chain

## Facts

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

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-address-token-transfers-csv-export-ecbd3491
```

Example prompt: Can you pull a CSV export of all token transfers for wallet address 0xABC123... on Ethereum (chain ID 1) from Blockscout, filtered to just incoming transfers between January 1 and March 31 2024?

## When to prefer this

Use this endpoint when you need structured, downloadable token transfer history for a specific wallet address on a known blockchain network, especially for audit trails, tax reporting, compliance checks, or bulk data analysis. It is preferable over JSON endpoints when the consumer needs spreadsheet-compatible output. Choose this over generic blockchain explorers when you need multichain support through a single unified API.

## Known failure modes

- Invalid chain_id returns 404 or empty response
- Invalid address_hash_param returns 400 bad request
- Date range with no matching transfers returns empty CSV with headers only
- Unsupported filter_type or filter_value combination may return unfiltered results
- Rate limiting or payment failure returns 402 or 429 error
- Very large address histories may require pagination or result in timeout

## 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 CSV file containing rows of token transfer events for the specified address on the given chain, each row including transaction hash, block number, timestamp, sender address, recipient address, token contract address, token symbol, token amount, and direction. Optionally filtered by date range and transfer direction or token type.

## 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",
     "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-address-token-transfers-csv-export-ecbd3491/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)