# Synapse API — Token Transfers Lookup

> Synapse API — Token Transfers Lookup 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-13).

Retrieves historical token transfer events for a given wallet address across blockchain networks, filtered by block range, contract addresses, and pagination options.

## Facts

- Endpoint: POST https://synapse-api-brown.vercel.app/api/stable/token/transfers
- 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/synapse-api-token-transfers-lookup-5a8f1108
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_o5yDvRsT3m4xw21XZVd3e

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

Example prompt: Show me all token transfers for wallet 0xAbC...123 from block 18000000 to 18500000, sorted in descending order, and limit results to 50 transfers — filter by the USDC contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48.

## When to prefer this

Use this endpoint when you need historical on-chain token transfer data for a specific wallet, optionally filtered by token contract addresses and block range. It is well-suited for portfolio analysis, compliance auditing, DeFi analytics, or any use case requiring paginated, ordered transfer history. Prefer this over generic blockchain explorers when you need programmatic, structured transfer data at pay-per-call pricing without a subscription.

## Known failure modes

- Invalid owner address format returns an error or empty result
- Invalid block range (fromBlock > toBlock) may return an error
- Unsupported contract address format causes rejection
- Missing required owner field returns a validation error
- pageKey from a different query context returns unexpected results
- Rate limit or payment failure (402) if USDC balance is insufficient

## 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 matching the query, each containing sender, recipient, token contract address, value, block number, transaction hash, and metadata. Results may be paginated via a pageKey for subsequent requests.

## 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-token-transfers-lookup-5a8f1108/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)