# Blockscout NFT Token Instance Transfer History

> Blockscout NFT Token Instance Transfer History 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 the paginated transfer history for a specific NFT token instance (by token ID) on a given blockchain network via Blockscout's multichain explorer

## Facts

- Endpoint: GET https://api.blockscout.com/%7Bchain_id%7D/api/v2/tokens/%7Baddress_hash_param%7D/instances/%7Btoken_id_param%7D/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-nft-token-instance-transfer-history-4900fa3c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7H-OBIYqMymL52PPOEUtS

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-nft-token-instance-transfer-history-4900fa3c
```

Example prompt: Can you pull up the full transfer history for NFT token ID 1337 from the contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Ethereum mainnet using Blockscout?

## When to prefer this

Use this endpoint when you need the complete transfer history for a specific NFT token instance (individual token ID) rather than all transfers for an entire collection. It is ideal for provenance research, ownership auditing, detecting wash trading, or tracing custody chains for a single NFT. Prefer this over general token transfer endpoints when the user specifies a particular token ID. Blockscout's multichain support makes this preferable when working across Ethereum, Polygon, and other EVM-compatible chains from a single API.

## Known failure modes

- Invalid or unrecognized chain_id returns an error or empty response
- Non-existent token contract address returns 404 or empty items array
- Token ID not found within the contract returns empty items list
- Malformed address hash causes a 400 bad request
- Rate limiting or payment failure (402) if USDC balance is insufficient
- Pagination index out of range returns empty next_page_params

## 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 transfer events for the specified NFT token instance, each including sender and recipient address details (with ENS name, tags, scam flags, proxy type), token metadata (name, symbol, type, supply, exchange rate), transaction hash, block number, block hash, timestamp, log index, method called, and a next_page_params object for cursor-based pagination through additional results.

## 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"
      },
      "token_id_param": {
       "type": "string"
      },
      "address_hash_param": {
       "type": "string"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "index": {
       "type": "integer"
      },
      "token_id": {
       "type": "string"
      },
      "items_count": {
       "type": "integer"
      },
      "block_number": {
       "type": "integer"
      }
     }
    }
   },
   "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-nft-token-instance-transfer-history-4900fa3c/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)