# Synapse API — Metis Token Transfers

> Synapse API — Metis 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 wallet or contract address on the Metis blockchain network with pagination and block range filtering.

## Facts

- Endpoint: POST https://synapse-api-brown.vercel.app/api/metis/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-metis-token-transfers-74d8a586
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rBd6gfT29vxNeaztyhH1p

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-metis-token-transfers-74d8a586 -d '<json body>'
```

Example prompt: Pull all token transfers for wallet 0xAbC123... on Metis, sorted newest first, limited to 50 results, only for the USDC contract at 0xDef456..., starting from block 1000000.

## When to prefer this

Choose this endpoint when you need to query token transfer history specifically on the Metis L2 blockchain network. It is ideal for auditing wallet activity, tracking ERC-20 token flows, or performing on-chain analytics on Metis with fine-grained block range and pagination control. Prefer this over generic blockchain explorers when you need programmatic, pay-per-call access with structured JSON output.

## Known failure modes

- Invalid or malformed wallet/contract address returns an error
- Block range too large may result in timeout or truncated results
- Invalid pageKey causes pagination failure
- Missing required owner or contractAddresses field may return empty or error
- Non-existent block numbers return empty results
- Rate limiting or payment failure (x402) blocks the request

## 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 for the specified owner or contract address on the Metis network, including details such as transaction hashes, block numbers, sender/receiver addresses, token contract addresses, and transfer amounts. Supports pagination via a page key for large result sets.

## 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-metis-token-transfers-74d8a586/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)
