# Ethereum Onchain Large-Trade & Whale Tracker

> Ethereum Onchain Large-Trade & Whale Tracker is a paid API for AI agents from ca-tax-api-mainnet.lxtap.workers.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-23).

Fetches recent large buys and sells of an ERC-20 token on Ethereum's deepest Uniswap v3 WETH/USDC pools, with USD size, trade side, wallet addresses, net flow, and top whale wallets.

## Facts

- Endpoint: GET https://ca-tax-api-mainnet.lxtap.workers.dev/eth/trades?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ethereum-onchain-large-trade-whale-tracker-7afe7e16
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ySyOeR4tRSlswMAeH-mWL

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 ethereum-onchain-large-trade-whale-tracker-7afe7e16
```

Example prompt: Show me all trades over $5,000 for the token at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum in the last 90 minutes, and tell me who the biggest buyers and sellers are.

## When to prefer this

Choose this endpoint when you need real-time whale and large-trade surveillance specifically for an ERC-20 token on Ethereum mainnet using Uniswap v3 WETH/USDC liquidity pools. It is ideal for DeFi traders, on-chain analysts, or alert systems that need to identify accumulation or distribution by large wallets, assess buy/sell pressure, and surface the specific transactions and wallets driving price action — all without running your own blockchain indexer.

## Known failure modes

- Invalid or non-existent token contract address returns an error or empty result
- Token has no Uniswap v3 WETH/USDC pool, returning no trades
- minutes parameter outside 5–240 range may be capped or rejected
- minUsd filter too high returns an empty trade list
- limit parameter outside 1–40 range rejected by validation
- Network congestion or RPC errors may cause delayed or failed responses
- Payment failure (x402) if USDC balance is insufficient

## How this service works

Pay-per-call data for AI agents, paid in USDC on Base with x402: token risk checks (rug check) on Base, Ethereum, Arbitrum, Optimism, Polygon and Solana, onchain reads (balances, transactions, gas, contracts, NFTs, whale trades, new pools, ENS and Basenames), ECB exchange rates, and Canadian sales tax and business days.

## Output

Returns a list of recent large trades on the token's deepest Uniswap v3 WETH/USDC pools on Ethereum, each with USD size, buy/sell side, wallet address, and transaction hash; aggregates including total buy volume, total sell volume, and net flow; and rankings of the wallets that bought or sold the most in the look-back window.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "token"
     ],
     "properties": {
      "limit": {
       "type": "string",
       "pattern": "^\\d{1,2}$",
       "description": "Max trades listed, 1 to 40, default 20"
      },
      "token": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "Token contract address on Ethereum"
      },
      "minUsd": {
       "type": "string",
       "pattern": "^\\d+(\\.\\d+)?$",
       "description": "Only list trades at least this large in USD, default 1000"
      },
      "minutes": {
       "type": "string",
       "pattern": "^\\d{1,3}$",
       "description": "Look-back window in minutes; 5 to 240, default 60 (capped at 12,000 blocks, about 50 minutes on Arbitrum)"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chain": "eth",
  "notes": "Trades from the 3 deepest WETH/USDC pools; other pairs and aggregator-internal routes are not counted. Wallets are transaction senders, looked up for the 40 largest trades.",
  "token": {
   "symbol": "UNI",
   "address": "0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984",
   "decimals": 18
  },
  "window": {
   "to": "2026-10-22T16:22:59.000Z",
   "from": "2026-10-22T15:22:59.000Z",
   "minutes": 60,
   "toBlock": 26249326,
   "fromBlock": 26249026
  },
  "summary": {
   "buys": 7,
   "sells": 22,
   "trades": 29,
   "netFlowUsd": -62919.8,
   "buyVolumeUsd": 775.696,
   "sellVolumeUsd": 63695.5,
   "largestTradeUsd": 12127.7
  },
  "nativeUsd": 2399.99,
  "topBuyers": [
   {
    "netUsd": 333.4,
    "trades": 1,
    "wallet": "0xFE272453cdBE33969155E54F5EAa9267bEEaa496",
    "soldUsd": 0,
    "boughtUsd": 333.4
   },
   {
    "netUsd": 192.4,
    "trades": 1,
    "wallet": "0xF2448FF6E5E68a8Ef70B62d9f7dfE3C43253A1F5",
    "soldUsd": 0,
    "boughtUsd": 192.4
   },
   {
    "netUsd": 98,
    "trades": 1,
    "wallet": "0x124Ae9d407c6644688F6A667D6a205f26AC36b30",
    "soldUsd": 0,
    "boughtUsd": 98
   },
   {
    "netUsd": 88.86,
    "trades": 1,
    "wallet": "0x5f73CfaCb6e225266946feE476A8b20902154565",
    "soldUsd": 0,
    "boughtUsd": 88.86
   },
   {
    "netUsd": 41.09,
    "trades": 1,
    "wallet": "0x544B0538C070C9B0872A1C34e124F088a3865aF3",
    "soldUsd": 0,
    "boughtUsd": 41.09
   }
  ],
  "topSellers": [
   {
    "netUsd": -14380,
    "trades": 5,
    "wallet": "0x5B43453FCE04b92E190f391a83136bfBeCEDEFd1",
    "soldUsd": 14380,
    "boughtUsd": 0
   },
   {
    "netUsd": -12130,
    "trades": 1,
    "wallet": "0xd5a809D6dbEe62A34Cf4106080C6e04B8d9ce285",
    "soldUsd": 12130,
    "boughtUsd": 0
   },
   {
    "netUsd": -8849,
    "trades": 1,
    "wallet": "0x8357eFA84F91013Bd6b285eF0f6b93C211cC3d9d",
    "soldUsd": 8849,
    "boughtUsd": 0
   },
   {
    "netUsd": -7432,
    "trades": 1,
    "wallet": "0x05a94A8Dd7eb1ba5b1114CC5eF18855A221Ac317",
    "soldUsd": 7432,
    "boughtUsd": 0
   },
   {
    "netUsd": -5504,
    "trades": 1,
    "wallet": "0x8bBe5D78bE45931Cf4815D8A00bf38c3DDD36782",
    "soldUsd": 5504,
    "boughtUsd": 0
   }
  ],
  "largeTrades": [
   {
    "tx": "0x254948fa1fc779edf4268e84b804fffefe7dd32db455779c54ad78f349b7b0cd",
    "dex": "uniswap-v3",
    "usd": 12127.7,
    "side": "sell",
    "block": 26249063,
    "wallet": "0xd5a809D6dbEe62A34Cf4106080C6e04B8d
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ethereum-onchain-large-trade-whale-tracker-7afe7e16/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ca-tax-api-mainnet.lxtap.workers.dev](https://www.zero.xyz/host/ca-tax-api-mainnet.lxtap.workers.dev/llms.txt)