# 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 or contract, with block range and pagination filtering, across 57+ blockchain networks.

## Facts

- Endpoint: POST https://phantom-api-omega.vercel.app/api/plasma/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-494a5d59
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rVL62L2XpPYOckXfNf5EX

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

Example prompt: Pull all token transfers for wallet 0xAbC...123 involving contract 0xDEF...456 from block 18000000 to 18500000, return up to 100 results in ascending order.

## When to prefer this

Choose this endpoint when you need historical on-chain token transfer data for a specific wallet or set of contracts, especially when you need to filter by block range, sort order, or paginate through large result sets. Prefer this over general blockchain explorers when you need programmatic, pay-per-call access without API key setup, and when you need coverage across 57+ networks via a single interface.

## Known failure modes

- Invalid or malformed wallet/contract address returns an error
- Block range too large may return timeout or truncated results
- Missing required owner field causes a validation error
- Invalid pageKey causes pagination to fail or return unexpected results
- Network or contract not supported on the queried chain returns empty or error
- Payment not included or insufficient USDC results in 402 Payment Required

## 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 on-chain token transfer records for the specified owner address and optional contract filter, including transfer details such as transaction hash, block number, from/to addresses, token contract, and amount. Also returns a pageKey for fetching subsequent pages if more results exist.

## 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-494a5d59/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)