# Blockscout Token Transfers API

> Blockscout Token Transfers API 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).

Retrieve paginated token transfer events (ERC-20, ERC-721, ERC-1155) for a specific blockchain network via chain ID

## Facts

- Endpoint: GET https://api.blockscout.com/%7Bchain_id%7D/api/v2/token-transfers
- 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-token-transfers-api-246dcac9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OpOzL_S4PD8LvaNKE26LJ

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-api-246dcac9
```

Example prompt: Pull the latest token transfers on Ethereum (chain ID 1) from Blockscout — give me the 25 most recent ones including the from/to addresses, token names, and transaction hashes.

## When to prefer this

Choose this endpoint when you need to enumerate token transfer events (ERC-20, ERC-721, ERC-1155) across a specific chain supported by Blockscout, especially when you need rich address metadata (ENS names, tags, reputation, proxy type) alongside transfer data. Prefer this over raw RPC calls when you want structured, enriched, paginated transfer data without running your own node. Best for multichain use cases where you need a unified API surface across many EVM chains.

## Known failure modes

- Invalid or unsupported chain_id returns an error or empty result
- Malformed batch_block_hash or batch_transaction_hash causes a 400 bad request
- Requesting a block number beyond the chain head returns empty items
- Invalid pagination cursor (index, items_count) may return unexpected results
- Chain is not indexed by Blockscout — endpoint returns 404 or empty
- Payment not completed — 402 Payment Required before data is returned

## 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 paginated list of token transfer objects, each containing: sender address (with tags, ENS name, contract flags, reputation), recipient address (same fields), token metadata (name, symbol, decimals, type, icon, exchange rate, holders count, market cap), transfer total amount, method called, log index, block number, block hash, transaction hash, timestamp, and next_page_params for cursor-based pagination.

## 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": {
      "type": {
       "type": "string"
      },
      "index": {
       "type": "integer"
      },
      "items_count": {
       "type": "integer"
      },
      "block_number": {
       "type": "integer"
      },
      "index_in_batch": {
       "type": "integer"
      },
      "batch_log_index": {
       "type": "integer"
      },
      "batch_block_hash": {
       "type": "string"
      },
      "batch_transaction_hash": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "to": {
     "hash": "string",
     "name": "string",
     "is_scam": true,
     "metadata": {},
     "proxy_type": "string",
     "reputation": "string",
     "is_contract": true,
     "is_verified": true,
     "public_tags": [
      {
       "label": "string",
       "address_hash": "string",
       "display_name": "string"
      }
     ],
     "private_tags": [
      {
       "label": "string",
       "address_hash": "string",
       "display_name": "string"
      }
     ],
     "ens_domain_name": "string",
     "implementations": [
      {
       "name": "string",
       "address_hash": "string"
      }
     ],
     "watchlist_names": [
      {
       "label": "string",
       "display_name": "string"
      }
     ]
    },
    "from": {
     "hash": "string",
     "name": "string",
     "is_scam": true,
     "metadata": {},
     "proxy_type": "string",
     "reputation": "string",
     "is_contract": true,
     "is_verified": true,
     "public_tags": [
      {
       "label": "string",
       "address_hash": "string",
       "display_name": "string"
      }
     ],
     "private_tags": [
      {
       "label": "string",
       "address_hash": "string",
       "display_name": "string"
      }
     ],
     "ens_domain_name": "string",
     "implementations": [
      {
       "name": "string",
       "address_hash": "string"
      }
     ],
     "watchlist_names": [
      {
       "label": "string",
       "display_name": "string"
      }
     ]
    },
    "type": "string",
    "token": {
     "name": "string",
     "type": {},
     "symbol": "string",
     "decimals": "string",
     "icon_url": "string",
     "reputation": "string",
     "volume_24h": "string",
     "bridge_type": "string",
     "address_hash": "string",
     "total_supply": "string",
     "exchange_rate": "string",
     "holders_count": "string",
     "foreign_address": "string",
     "origin_chain_id": "string",
     "circulating_supply": "string",
     "circulating_market_cap": "string"
    },
    "total": {},
    "method": "string",
    "log_index": 0,
    "timestamp": "string",
    "block_hash": "string",
    "token_type": "string",
    "block_number": 0,
    "transaction_hash": "string"
   }
  ],
  "next_page_params": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockscout-token-transfers-api-246dcac9/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)