# Phantom API — Optimism Token Transfers

> Phantom API — Optimism Token Transfers 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-10-16).

Retrieves ERC-20 token transfer history for a given wallet or contract address on the Optimism network, with pagination and block range filtering.

## Facts

- Endpoint: POST https://phantom-api-omega.vercel.app/api/optimism/token/transfers?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/phantom-api-optimism-token-transfers-a6a0b14d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xPbiusP0jqQqMe0geV6CX

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-optimism-token-transfers-a6a0b14d -d '<json body>'
```

Example prompt: Pull all ERC-20 token transfers for wallet 0xAbC...123 on Optimism from block 100000 to 200000, sorted in ascending order, and return up to 50 results.

## When to prefer this

Use this endpoint when you specifically need ERC-20 token transfer history on the Optimism L2 network. It is ideal for wallet audits, DeFi activity analysis, and paginated bulk transfer retrieval on Optimism. Prefer this over generic Ethereum mainnet endpoints when the target chain is Optimism, and over explorers like Etherscan when you need programmatic, structured, pay-per-call access without API key management.

## Known failure modes

- Invalid owner address format returns validation error
- Unknown or malformed contractAddresses cause empty or error response
- Invalid block numbers (e.g. toBlock before fromBlock) may return empty results or error
- Missing required owner field may result in a 400 error
- Expired or invalid pageKey causes pagination failure
- Rate limit or payment failure returns 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

A list of token transfer events on the Optimism network, each including sender, recipient, token contract address, amount, transaction hash, block number, and log index. Also returns a pagination key (pageKey) if more results are available.

## 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-optimism-token-transfers-a6a0b14d/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)