# Phantom API — Citrea Transaction History

> Phantom API — Citrea Transaction History 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-13).

Retrieves paginated transaction history for addresses on the Citrea blockchain network

## Facts

- Endpoint: POST https://phantom-api-omega.vercel.app/api/citrea/tx/history
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/phantom-api-citrea-transaction-history-c78b5d95
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PzYxgkaJmI-6ZMweGkHNY

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-transaction-history-c78b5d95 -d '<json body>'
```

Example prompt: Pull the last 25 transactions sent from the Citrea address 0xAbC123... in descending order, including metadata and excluding zero-value transfers.

## When to prefer this

Use this endpoint when you need historical transaction data specifically on the Citrea network, with flexible filtering by address direction, block range, transaction category, and value. Prefer this over general-purpose blockchain explorers when you need programmatic, pay-per-call access with pagination support and metadata enrichment for Citrea transactions.

## Known failure modes

- Invalid or malformed address returns an error response
- fromBlock greater than toBlock results in an empty or error response
- Invalid pageKey causes pagination failure or empty result
- Unsupported category values may be silently ignored or cause an error
- Network unavailability or Citrea RPC downtime returns a 5xx error
- Exceeding maxCount limits may result in truncated results
- Payment failure via x402 protocol blocks access with a 402 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 paginated list of transaction records for the specified Citrea address(es), including transaction hashes, block numbers, asset categories, sender/receiver addresses, values, and optional metadata. Supports cursor-based pagination via a pageKey for iterating through large result sets.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "order": {
   "enum": [
    "asc",
    "desc"
   ],
   "type": "string"
  },
  "pageKey": {
   "type": "string"
  },
  "toBlock": {
   "type": "string"
  },
  "category": {
   "type": "array",
   "items": {
    "type": "string"
   }
  },
  "maxCount": {
   "type": "number"
  },
  "fromBlock": {
   "type": "string"
  },
  "toAddress": {
   "type": "string"
  },
  "fromAddress": {
   "type": "string"
  },
  "withMetadata": {
   "type": "boolean"
  },
  "excludeZeroValue": {
   "type": "boolean"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/phantom-api-citrea-transaction-history-c78b5d95/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)