# Phantom API — Token Transfers Lookup

> Phantom API — Token Transfers Lookup is a paid API for AI agents from phantom-api-omega.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Retrieves on-chain token transfer history for a given wallet address, optionally filtered by contract addresses, block range, and sort order.

## Facts

- Endpoint: POST https://phantom-api-omega.vercel.app/api/adi/token/transfers
- 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/phantom-api-token-transfers-lookup-2e0c253b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_50KjpSjYqA5zYDVy3S4Rs

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 phantom-api-token-transfers-lookup-2e0c253b -d '<json body>'
```

Example prompt: Pull all token transfers for wallet 0xAbC123...def456 from block 18000000 to 18500000, sorted descending, and limit it to 50 results for the USDC contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48.

## When to prefer this

Choose this endpoint when you need historical token transfer data for a specific wallet address across one or more token contracts, especially when filtering by block range or paginating through large transfer histories. Prefer it over general blockchain explorers when you need structured JSON output suitable for programmatic processing by an AI agent. It is particularly well-suited for DeFi auditing, portfolio tracking, and on-chain activity analysis across 57+ supported networks.

## Known failure modes

- Invalid or malformed wallet address returns an error or empty result set
- Unsupported network or block range out of bounds may return empty transfers
- Missing required 'owner' field causes a 400-level validation error
- Invalid pageKey causes pagination to fail or restart
- Rate limiting or payment failure (x402) blocks the request
- Very large block ranges may time out or return truncated results

## How this service works

Lightning-fast access to blockchain data, smart contract insights, and Web3 infrastructure across 57+ networks. Pay-per-call via x402.

## Output

Returns a paginated list of token transfer events for the specified wallet, including sender/receiver addresses, token contract, amount transferred, block number, transaction hash, and a page key for fetching subsequent pages.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "order": {
   "enum": [
    "asc",
    "desc"
   ],
   "type": "string"
  },
  "owner": {
   "type": "string"
  },
  "pageKey": {
   "type": "string"
  },
  "toBlock": {
   "type": "string"
  },
  "maxCount": {
   "type": "number"
  },
  "fromBlock": {
   "type": "string"
  },
  "contractAddresses": {
   "type": "array",
   "items": {
    "type": "string"
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/phantom-api-token-transfers-lookup-2e0c253b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from phantom-api-omega.vercel.app](https://www.zero.xyz/host/phantom-api-omega.vercel.app/llms.txt)