# NFT Transfer History by Address

> NFT Transfer History by Address is a paid API for AI agents from x402-stock-indicators.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns the full NFT transfer history for a given Ethereum wallet address, including token names, contract addresses, transaction hashes, and timestamps.

## Facts

- Endpoint: GET https://x402-stock-indicators.vercel.app/nft-transfers/%7Baddress%7D
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nft-transfer-history-by-address-720ca754
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EmS2Ue-TLmzgJSZOn6sNm

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 nft-transfer-history-by-address-720ca754
```

Example prompt: Pull up the full NFT transfer history for Ethereum address 0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae — I want to see every token that was sent or received, including the token names, contracts, and timestamps.

## When to prefer this

Choose this endpoint when you need on-chain NFT transfer history for an Ethereum address without managing API keys or subscriptions — it's ideal for pay-per-call agent workflows using the x402 protocol with USDC micropayments. Prefer it over subscription-based NFT APIs when usage is sporadic or cost-per-call needs to be predictable at $0.01 USDC.

## Known failure modes

- Invalid or malformed Ethereum address returns an error or empty result
- Address with no NFT activity returns an empty transfers array
- Payment failure via x402 protocol results in 402 Payment Required response
- Network or upstream data provider downtime causes 503 or timeout
- Rate limiting or capacity issues on the Vercel deployment

## How this service works

Pay-per-call stock, macro, on-chain, and crypto data over the x402 protocol. USDC on Base or Solana, no API keys, no subscriptions.

## Output

A JSON object containing the queried wallet address, the total transfer count, the chain identifier (e.g. 'eth'), and an array of transfer records each including sender address, recipient address, transaction hash, token ID, token name, token symbol, token contract address, block number, and ISO 8601 timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chain": "eth",
  "count": 1,
  "address": "0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae",
  "transfers": [
   {
    "to": "0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae",
    "from": "0x0000000000000000000000000000000000000000",
    "hash": "0xc71f76fabb591f950526d26b6f64c371a24967632ac7ee7d881d549753469492",
    "token_id": "11",
    "timestamp": "2025-09-05T13:34:35+00:00",
    "token_name": "Funds To Leave Abuse",
    "block_number": 23297036,
    "token_symbol": "FTLA",
    "token_contract": "0x9500b6e1a6a7c84c9cbba847ac4a524b7452ef1e"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nft-transfer-history-by-address-720ca754/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-stock-indicators.vercel.app](https://www.zero.xyz/host/x402-stock-indicators.vercel.app/llms.txt)