# Synapse API — Optimism Token Transfers

> Synapse API — Optimism 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 ERC-20 and native token transfer history for a given address on the Optimism blockchain network, with filtering by block range and contract address.

## Facts

- Endpoint: POST https://synapse-api-brown.vercel.app/api/optimism/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-optimism-token-transfers-57c5d4bc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5GhiFrknz8OtQsSPFun0u

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-optimism-token-transfers-57c5d4bc -d '<json body>'
```

Example prompt: Pull all token transfers for the Optimism wallet 0xAbC...123, sorted descending, covering blocks 110000000 to 115000000, and limit results to 100 entries — include transfers for the USDC contract at 0x7F5c764cBc14f9669B88837ca1490cCa17c31607.

## When to prefer this

Use this endpoint when you need token transfer history specifically on the Optimism L2 network. It is ideal for wallet auditing, portfolio tracking, DeFi analytics, or compliance checks scoped to Optimism. Prefer this over Ethereum mainnet endpoints when the user's wallet activity is on Optimism (OP chain). Supports pagination for large datasets via pageKey.

## Known failure modes

- Invalid or malformed owner address returns an error or empty result
- Unknown contractAddress silently returns no results
- Invalid block number format causes a 400 error
- pageKey expiration or invalidity causes a pagination error
- Rate limiting or payment failure returns 402 or 429
- Very wide block ranges may time out or return truncated 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

Returns a paginated list of token transfer events on the Optimism network for the specified wallet, including sender, recipient, token contract, amount, block number, and transaction hash. A pageKey is provided when 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/synapse-api-optimism-token-transfers-57c5d4bc/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)