# Blockscout Address Token Transfers

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

List all token transfers (ERC-20, ERC-721, ERC-1155) involving a specific blockchain address on a given chain, with filtering by token type, direction, and pagination

## Facts

- Endpoint: GET https://api.blockscout.com/:chain_id/api/v2/addresses/:address_hash_param/token-transfers?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockscout-address-token-transfers-96d64189
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_V7GOXbhGkEANtaDBCXRLC

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-96d64189
```

Example prompt: Show me all token transfers involving the address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum mainnet — filter for ERC-20 transfers only and give me the most recent ones first.

## When to prefer this

Use this endpoint when you need a full token transfer history for a specific address across EVM-compatible chains indexed by Blockscout, especially when you need filtering by token type (ERC-20, ERC-721, ERC-1155) or specific token contract. Prefer over general transaction endpoints when the focus is token movements rather than native coin transfers or contract interactions.

## Known failure modes

- Invalid or malformed address hash returns a 400 error
- Unsupported or incorrect chain_id returns a 404 or empty result
- Invalid token type filter string returns an error or empty results
- Requesting a page beyond available data returns an empty items array
- Rate limiting or payment failures return 402 or 429 responses
- Chain not indexed by Blockscout returns no data

## How this service works

Access to api/v2/addresses/:address_hash/token-transfers. List token transfers involving a specific address with filtering options

## Output

A paginated list of token transfer objects, each containing the transaction hash, block number, timestamp, sender and receiver addresses, token contract details (name, symbol, type), token ID (for NFTs), and amount transferred. Includes pagination cursors for fetching subsequent pages.

## 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": {
      "type": {
       "type": "string"
      },
      "index": {
       "type": "integer"
      },
      "token": {
       "type": "string"
      },
      "filter": {
       "type": "string"
      },
      "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"
    }
   }
  }
 }
}
```

## More

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