# Blockscout Transaction Token Transfers

> Blockscout Transaction 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-09-14).

Retrieves all token transfers (ERC-20, ERC-721, ERC-1155, etc.) associated with a specific transaction hash on a given blockchain network

## Facts

- Endpoint: GET https://api.blockscout.com/%7Bchain_id%7D/api/v2/transactions/%7Btransaction_hash_param%7D/token-transfers
- 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-transaction-token-transfers-8230888b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7qSnFdolI7WatXeay0IEB

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-transaction-token-transfers-8230888b
```

Example prompt: Can you pull all the token transfers from transaction 0x4a1b2c3d... on Ethereum (chain ID 1) using Blockscout, and show me which tokens moved and between which addresses?

## When to prefer this

Use this endpoint when you need to inspect token-level movements within a specific transaction on any Blockscout-supported chain. It is more granular than a general transaction lookup, providing per-token transfer records with rich address and token metadata. Prefer it over generic blockchain RPC calls when you need structured, human-readable token transfer data including ENS names, scam flags, and token icons. Ideal for DeFi analytics, NFT provenance checks, airdrop audits, and compliance reviews.

## Known failure modes

- Invalid or unknown transaction hash returns empty items array or 404
- Unsupported or incorrect chain_id returns an error or empty response
- Transaction exists but has no token transfers — returns empty items list
- Pagination parameters out of range may return empty results
- Rate limiting or payment failure if x402 payment is not correctly handled
- Malformed query parameters may result in 400 Bad Request

## 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

Returns a paginated list of token transfer objects for the given transaction, each containing: sender and receiver address details (hash, name, tags, ENS domain, contract/scam flags), token metadata (name, symbol, type, decimals, icon, exchange rate, total supply), transfer amount/total, log index, block number, block hash, timestamp, and method called. Also includes next_page_params for 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"
      },
      "transaction_hash_param": {
       "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-transaction-token-transfers-8230888b/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)