# Phantom API – Citrea Token Transfers

> Phantom API – Citrea 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-09-14).

Retrieves token transfer history for a given address or contract on the Citrea network, with pagination and block range filtering.

## Facts

- Endpoint: POST https://phantom-api-omega.vercel.app/api/citrea/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-citrea-token-transfers-402f53e2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_V6GFS9AzAfn0cwHinyliG

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-citrea-token-transfers-402f53e2 -d '<json body>'
```

Example prompt: Pull all token transfers for wallet 0xAbC...123 on the Citrea network from block 100000 to 200000, sorted in ascending order, returning up to 100 results.

## When to prefer this

Use this endpoint when you need on-chain token transfer data specifically from the Citrea network, with support for address-level filtering, block range scoping, and paginated retrieval. Prefer this over generic blockchain explorers when you need programmatic, pay-per-call access without rate limits or API key registration.

## Known failure modes

- Invalid or malformed wallet/contract address returns a 400 error
- Unsupported block range or out-of-range block numbers may return empty results or an error
- Missing required owner field may result in an error or unfiltered response
- Invalid pageKey causes pagination failure or empty result set
- Payment not fulfilled (HTTP 402) when x402 payment header is absent or incorrect

## 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 Citrea network matching the query filters, each including sender, recipient, token contract address, amount, transaction hash, and block number. A pagination key is returned 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-citrea-token-transfers-402f53e2/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)