# Synapse API — Citrea Token Transfers

> Synapse API — Citrea Token Transfers is a paid API for AI agents from synapse-api-brown.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-16).

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

## Facts

- Endpoint: POST https://synapse-api-brown.vercel.app/api/citrea/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/synapse-api-citrea-token-transfers-2fd231a5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XtFW7GLh4_Agg_PoBvd2q

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 synapse-api-citrea-token-transfers-2fd231a5 -d '<json body>'
```

Example prompt: Fetch all token transfers for wallet 0xABC123... on the Citrea network between block 100000 and 200000, sorted ascending, and return up to 50 results.

## When to prefer this

Choose this endpoint when you need on-chain token transfer data specifically from the Citrea Bitcoin ZK-rollup network. It is suitable when you need paginated, filterable transfer histories for specific wallets or token contracts on Citrea, and want pay-per-call pricing via x402 without a subscription.

## Known failure modes

- Invalid owner address format returns an error
- fromBlock or toBlock values out of range or malformed may return empty results or errors
- Invalid pageKey causes pagination failure
- Exceeding maxCount limits may truncate results or return an error
- Contracts not deployed on Citrea return empty transfer lists
- Rate limiting or payment failure (x402) blocks access

## How this service works

High-speed API suite for AI processing, web scraping, and smart data utilities across 57+ blockchain networks. Pay-per-call via x402.

## Output

Returns a list of token transfer events on the Citrea network for the specified owner address, optionally filtered by contract addresses and block range. Each record typically includes sender, recipient, token contract, amount, block number, and transaction hash.

## 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/synapse-api-citrea-token-transfers-2fd231a5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from synapse-api-brown.vercel.app](https://www.zero.xyz/host/synapse-api-brown.vercel.app/llms.txt)