# Token Transfers by Address

> Token Transfers by Address is a paid API for AI agents from x402-stock-indicators.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Fetches on-chain ERC-20 token transfer history for a given wallet or contract address, paid per call via x402/USDC.

## Facts

- Endpoint: GET https://x402-stock-indicators.vercel.app/token-transfers/%7Baddress%7D
- 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/token-transfers-by-address-0af841dd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_R8pIAnrV2xuVBcNcbPyeM

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 token-transfers-by-address-0af841dd
```

Example prompt: Pull all token transfers for the Ethereum address 0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae — I want to see who sent tokens to it and what tokens were involved.

## When to prefer this

Choose this endpoint when you need on-chain ERC-20 token transfer history for a specific wallet or contract address without setting up API keys or subscriptions. It is ideal for pay-per-call scenarios where you query infrequently and want to pay only $0.01 USDC per lookup via the x402 protocol. Prefer it over centralized data providers when you want crypto-native, permissionless access to transfer data.

## Known failure modes

- Invalid or malformed address returns an error or empty result
- Address with no transfer history returns count 0 and empty transfers array
- Payment failure (insufficient USDC balance or x402 protocol error) blocks the call
- Rate limiting or Vercel cold-start may cause latency spikes
- Unsupported chain or address format may return an error

## 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 count of transfers, and an array of transfer records. Each record includes sender (from), recipient (to), transaction hash, token value in human-readable and raw form, token name and symbol, token contract address, block number, and ISO timestamp.

## 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/token-transfers-by-address-0af841dd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-stock-indicators.vercel.app](https://www.zero.xyz/host/x402-stock-indicators.vercel.app/llms.txt)