# 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-09-10). Retrieve paginated token transfer history for a specific address on a given blockchain network via Blockscout's multichain explorer ## Facts - Endpoint: GET https://api.blockscout.com/%7Bchain_id%7D/api/v2/addresses/%7Baddress_hash_param%7D/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-address-token-transfers-b4681958 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gc3VWxI8UnbEHL-ggMY58 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-b4681958 ``` Example prompt: Show me all token transfers for address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on the Ethereum mainnet chain — I want to see what tokens they've been sending and receiving. ## When to prefer this Use this endpoint when you need detailed token transfer history (ERC-20, ERC-721, ERC-1155) for a specific wallet or contract address on a specific supported blockchain. It is ideal for portfolio auditing, compliance checks, NFT provenance tracking, and DeFi activity analysis. Prefer this over generic transaction endpoints when you specifically need token-level transfer data rather than native currency transactions. Choose Blockscout when you need an open, multichain explorer with rich address metadata including ENS names, scam flags, and proxy information. ## Known failure modes - Invalid chain_id returns 404 or empty result - Malformed address hash returns 400 bad request - Address with no token transfers returns empty items array - Unsupported token type filter returns 400 or empty results - Rate limiting or payment failure returns 402 or 429 - Pagination parameters out of range may return empty next page ## 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 records associated with the given address on the specified chain. Each record includes sender and recipient address objects (with hash, name, tags, ENS domain, contract verification status, scam flag), token metadata (name, symbol, type, decimals, icon URL, exchange rate, supply), transfer total/amount, method called, log index, block number, block hash, transaction hash, and timestamp. Also includes 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" }, "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" } } } } } ``` ## 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-address-token-transfers-b4681958/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)