# Financial Data x402 — Token Transfers by Address

> Financial Data x402 — Token Transfers by Address is a paid API for AI agents from x402financialdata.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Returns the full list of on-chain token transfer history for a given wallet or contract address, including sender, recipient, value, and token metadata.

## Facts

- Endpoint: GET https://x402financialdata.com/token-transfers/%7Baddress%7D
- 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/financial-data-x402-token-transfers-by-address-ab79224a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dQcp7_BxhXemgh2nJHIji

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 financial-data-x402-token-transfers-by-address-ab79224a
```

Example prompt: Can you pull the full token transfer history for the Ethereum address 0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae — I want to see who sent and received tokens, the amounts, and when each transfer happened?

## When to prefer this

Choose this endpoint when you need on-chain token transfer history for a specific wallet or contract address without managing API keys or subscriptions. It is ideal for AI agents that support x402 micropayments (USDC on Base or Solana) and need pay-per-call access to blockchain data. Prefer it over subscription-based alternatives like Etherscan or Alchemy APIs when you want frictionless, per-query billing without account provisioning.

## Known failure modes

- Invalid or malformed address returns an error or empty result
- Address with no transfer history returns an empty transfers array
- Network or upstream blockchain data provider outage may return a 5xx error
- Payment failure via x402 (insufficient USDC balance or unsupported network) blocks the request
- Rate limits or temporary unavailability may cause timeouts

## How this service works

Pay-per-call stock, macro, on-chain, and crypto data over the x402 protocol. USDC on Base or Solana, no API keys, no subscriptions.

## Output

Returns a JSON object containing the queried address, the blockchain chain identifier, a total transfer count, and an array of transfer records. Each record includes the sender and recipient addresses, transaction hash, token value (both human-readable and raw), token name and symbol, token contract address, block number, and UTC timestamp of the transfer.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chain": "eth",
  "count": 1,
  "address": "0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae",
  "transfers": [
   {
    "to": "0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae",
    "from": "0x28c6c06298d514db089934071355e5743bf21d60",
    "hash": "0x8a1a9989bda84f80143181a68bc137ecefa64d0d4ebde45dd94fc0cf49e70cb",
    "value": 125.5,
    "timestamp": "2026-07-30T03:43:30+00:00",
    "value_raw": "125500000",
    "token_name": "USD Coin",
    "block_number": 21500123,
    "token_symbol": "USDC",
    "token_contract": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"
   }
  ],
  "contract_address": null
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/financial-data-x402-token-transfers-by-address-ab79224a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402financialdata.com](https://www.zero.xyz/host/x402financialdata.com/llms.txt)