# Whale Wallet Tracker

> Whale Wallet Tracker is a paid API for AI agents from api.timzinin.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Tracks on-chain activity for a given Ethereum wallet address, returning ETH balance, large native movements, and recent token transfers

## Facts

- Endpoint: POST https://api.timzinin.com/api/whale-wallet-tracker
- 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/whale-wallet-tracker-02984e05
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3Axjcghl_sr-tlfZPIlny

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 whale-wallet-tracker-02984e05 -d '<json body>'
```

Example prompt: Can you check on-chain activity for the Ethereum wallet 0x28C6c06298d514Db089934071355E5743bf21d60 — I want to see its current ETH balance, any large native movements of 1 ETH or more, and its recent token transfers?

## When to prefer this

Choose this endpoint when you need a quick, pay-per-call on-chain snapshot of a specific Ethereum wallet — especially for whale tracking use cases where ETH balance, large native movements, and recent token transfers are all needed in a single call. Prefer this over block explorer APIs when you want structured JSON output with pre-filtered large-movement detection rather than raw transaction lists.

## Known failure modes

- Wallet address not found or invalid — returns found: false
- RPC or data source errors surfaced in sourceErrors fields (balance, tokenTx, nativeTx)
- Chain ID not supported — no results returned
- Malformed wallet address — API-level error or empty results
- Network timeout — run_ms elevated, partial data possible
- Payment not settled — x402 payment required before data is returned

## How this service works

Pay-per-call data & tool APIs

## Output

A JSON object with metadata (run time in ms, settlement status, item count) and a results array. Each result includes: whether the wallet was found, the wallet address, chain ID, a human-readable summary, ETH and native token balance, count of large native movements (≥1 ETH), up to 20 recent token transfers (with timestamp, amount, direction, token symbol), large movement details (timestamp, tx hash, value in ETH, direction, counterparty address), source coverage status for balance/token/native queries, and any source errors.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chainId": {
   "type": "integer"
  },
  "wallets": {
   "type": "array",
   "maxItems": 100
  },
  "minValueEth": {
   "type": "number"
  },
  "maxConcurrency": {
   "type": "integer",
   "maximum": 10,
   "minimum": 1
  },
  "etherscanApiKey": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "meta": {
   "run_ms": 1200,
   "settled": true,
   "item_count": 1
  },
  "results": [
   {
    "found": true,
    "wallet": "0x28C6c06298d514Db089934071355E5743bf21d60",
    "chainId": 1,
    "summary": "0x28C6c06298d514Db089934071355E5743bf21d60 — 215109.977692 ETH, 3 large native movement(s) ≥ 1 ETH, 20 recent token transfer(s).",
    "checkedAt": "2026-07-26T15:12:23.556Z",
    "ethBalance": 215109.977692,
    "nativeSymbol": "ETH",
    "sourceErrors": {
     "balance": null,
     "tokenTx": null,
     "nativeTx": null
    },
    "movementCount": 3,
    "nativeBalance": 215109.977692,
    "largeMovements": [
     {
      "ts": "2026-07-26T15:05:35.000Z",
      "hash": "0x93b01fdafe0f9d7a35fba48e832c584a1862e478db58434171f52b9c02b64de8",
      "valueEth": 365,
      "direction": "out",
      "counterparty": "0x6455327f820edd69c4cd665b995e0fec679d7f9e"
     },
     {
      "ts": "2026-07-26T15:04:35.000Z",
      "hash": "0xf9c69ad67a5c3c41c3f8984e403cf367511ceaef101ac243af625cb347099924",
      "valueEth": 1508,
      "direction": "out",
      "counterparty": "0xf8191d98ae98d2f7abdfb63a9b0b812b93c873aa"
     },
     "…"
    ],
    "sourceCoverage": {
     "balance": "ok",
     "tokenTx": "ok",
     "nativeTx": "ok"
    },
    "tokenTransfers": [
     {
      "ts": "2026-07-26T15:12:11.000Z",
      "amount": 10374.7676,
      "direction": "out",
      "tokenSymbol": "CFG"
     },
     {
      "ts": "2026-07-26T15:12:11.000Z",
      "amount": 266.26,
      "direction": "out",
      "tokenSymbol": "USDT"
     },
     "…"
    ]
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/whale-wallet-tracker-02984e05/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.timzinin.com](https://www.zero.xyz/host/api.timzinin.com/llms.txt)