# 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 owner, with optional filtering by contract addresses, block range, and pagination.

## Facts

- Endpoint: POST https://phantom-api-omega.vercel.app/api/stable/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-a6c0b6d2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_S888V1bWvN4-yENj6tSdt

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-a6c0b6d2 -d '<json body>'
```

Example prompt: Pull all token transfers for wallet 0xABC...123 between block 18000000 and 18500000, sorted descending, and only include transfers of the USDC contract at 0xA0b8...eB48.

## When to prefer this

Use this endpoint when you need paginated, filterable on-chain token transfer history for a specific wallet, optionally scoped to particular token contracts and block ranges. Prefer it over general blockchain explorers when you need programmatic, structured JSON output for agent workflows, auditing, or portfolio reconstruction tasks.

## Known failure modes

- Invalid or malformed wallet address returns an error or empty result
- Block range too large may cause timeouts or truncated results
- Invalid contract address in contractAddresses array may cause errors
- Expired or invalid pageKey returns pagination error
- Network or rate-limit errors returning 5xx responses
- Unsupported chain may return empty or error response

## 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 list of token transfer events matching the query, each including sender, receiver, token contract address, amount, block number, and transaction hash. Supports cursor-based pagination via a pageKey for large result sets.

## 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-a6c0b6d2/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)