# Synapse API — Celo Token Transfers

> Synapse API — Celo 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-09-15).

Retrieves token transfer history for a given owner address on the Celo blockchain, with filtering by block range, contract address, and pagination support.

## Facts

- Endpoint: POST https://synapse-api-brown.vercel.app/api/celo/token/transfers
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/synapse-api-celo-token-transfers-5fdae0e9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ecq5a1ixnGYuTJf6V64r1

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-celo-token-transfers-5fdae0e9 -d '<json body>'
```

Example prompt: Pull all token transfers for Celo address 0x1234...abcd from block 18000000 to 18500000, sorted descending, and return up to 100 results — include only transfers involving the cUSD contract 0x765de816845861e75a25fca122bb6898b8b1282a.

## When to prefer this

Use this endpoint when you need historical token transfer data specifically on the Celo blockchain, especially when you need filtering by block range or contract address. Prefer this over general Ethereum endpoints when the target address is on Celo. Best for auditing wallet activity, building transaction history views, or detecting specific token movements on Celo.

## Known failure modes

- Invalid owner address format returns an error or empty result
- Invalid block range (fromBlock > toBlock) may return an error
- Unknown or malformed contractAddresses silently return no matching transfers
- Missing required owner field causes a 400 bad request
- Rate limiting or payment failure results in 402 or 429 response
- Very wide block ranges may time out or return partial results

## 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

A list of token transfer events for the specified Celo address, each containing transaction hash, block number, from/to addresses, token contract address, token amount, and asset metadata. Also returns a pagination key for fetching subsequent pages when results are truncated.

## 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-celo-token-transfers-5fdae0e9/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)