# Phantom API — Gnosis Token Transfers

> Phantom API — Gnosis Token Transfers is a paid API for AI agents from phantom-api-omega.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

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

## Facts

- Endpoint: POST https://phantom-api-omega.vercel.app/api/gnosis/token/transfers
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/phantom-api-gnosis-token-transfers-e41bf5a0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KcbPV9mNJchJ0OCmUUYas

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 phantom-api-gnosis-token-transfers-e41bf5a0 -d '<json body>'
```

Example prompt: Pull all token transfers for Gnosis wallet 0xAbC123...def in descending order, limited to 100 results, only for contracts 0xToken1 and 0xToken2, between blocks 25000000 and 26000000.

## When to prefer this

Use this endpoint when you need to retrieve the full or filtered token transfer history for a specific wallet or set of contracts on the Gnosis (xDai) chain. It is ideal for auditing token flows, building portfolio trackers, or powering DeFi analytics dashboards specifically on Gnosis. Prefer this over generic blockchain explorers when you need structured, paginated, programmatic access to transfer data with block-range filtering.

## Known failure modes

- Invalid or malformed owner address returns an error or empty result set
- Invalid block number format (non-hex or non-numeric) causes a bad request error
- Unrecognized pageKey causes pagination to fail or reset
- Too-large maxCount may be silently capped or rejected
- Request with no owner address may return an error or require at least one filter
- Network or RPC timeout on heavy historical queries across many blocks

## How this service works

Lightning-fast access to blockchain data, smart contract insights, and Web3 infrastructure across 57+ networks. Pay-per-call via x402.

## Output

A list of token transfer events associated with the specified owner address on the Gnosis chain, including details such as sender, recipient, token contract, amount, and block number. Results are paginated and can be filtered by block range and specific contract addresses.

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