# Blockscout Advanced Filters CSV Export

> Blockscout Advanced Filters 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-10).

Exports filtered blockchain transaction data as a CSV file for a specified chain, with rich filtering by address, token, method, amount, and time range

## Facts

- Endpoint: GET https://api.blockscout.com/%7Bchain_id%7D/api/v2/advanced-filters/csv
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockscout-advanced-filters-csv-export-d760de2b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_y_qtGNtHXhMqnZj1p3gII

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-advanced-filters-csv-export-d760de2b
```

Example prompt: Export a CSV of all ERC-20 token transfers on Ethereum (chain_id: 1) involving address 0xAbC...123 as the sender, from January 1 2024 to March 31 2024, filtered to only include USDC transfers.

## When to prefer this

Use this endpoint when you need to bulk-export structured blockchain data for a specific chain in CSV format for offline analysis, accounting, compliance, or reporting purposes. It is ideal when you need to apply multiple simultaneous filters (address, token, method, time range, amount) in a single call and receive a machine-readable flat file. Prefer this over JSON endpoints when downstream tooling (Excel, Google Sheets, pandas) expects CSV input directly.

## Known failure modes

- Invalid chain_id returns 404 or empty response
- Malformed address hashes in filter params return 400 bad request
- Overly broad filters with no pagination may time out or return large files
- Unsupported transaction_types or method values may silently filter out all results
- Date range too narrow or too broad may return empty CSV or error
- Network-specific endpoints unavailable for some lesser-supported chain IDs

## 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 blockchain transactions, token transfers, or internal transactions matching the specified filters. Each row typically includes fields such as transaction hash, block number, timestamp, from/to addresses, value/amount, token symbol, method name, and transaction type — ready for import into spreadsheets or data analysis tools.

## 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"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "age_to": {
       "type": "string"
      },
      "methods": {
       "type": "string"
      },
      "age_from": {
       "type": "string"
      },
      "amount_to": {
       "type": "string"
      },
      "amount_from": {
       "type": "string"
      },
      "block_number": {
       "type": "string"
      },
      "methods_names": {
       "type": "string"
      },
      "address_relation": {
       "type": "string"
      },
      "transaction_index": {
       "type": "string"
      },
      "transaction_types": {
       "type": "string"
      },
      "token_transfer_index": {
       "type": "string"
      },
      "internal_transaction_index": {
       "type": "string"
      },
      "token_transfer_batch_index": {
       "type": "string"
      },
      "to_address_hashes_to_exclude": {
       "type": "string"
      },
      "to_address_hashes_to_include": {
       "type": "string"
      },
      "from_address_hashes_to_exclude": {
       "type": "string"
      },
      "from_address_hashes_to_include": {
       "type": "string"
      },
      "token_contract_symbols_to_exclude": {
       "type": "string"
      },
      "token_contract_symbols_to_include": {
       "type": "string"
      },
      "token_contract_address_hashes_to_exclude": {
       "type": "string"
      },
      "token_contract_address_hashes_to_include": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockscout-advanced-filters-csv-export-d760de2b/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)