# Ethereum ERC-20 Whale & Large-Trade Tracker

> Ethereum ERC-20 Whale & Large-Trade Tracker is a paid API for AI agents from onchaincheck.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-29).

Returns buy/sell trades, volume, net flow, and top whale wallets for an ERC-20 token on Ethereum Uniswap v3 WETH/USDC pools over a configurable look-back window.

## Facts

- Endpoint: GET https://onchaincheck.dev/eth/trades?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ethereum-erc-20-whale-large-trade-tracker-4ef9c96b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9rLzGyFEocPHpJLZIDfh9

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-erc-20-whale-large-trade-tracker-4ef9c96b
```

Example prompt: Show me all large trades (over $5,000) for the UNI token at 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 on Ethereum in the last 60 minutes — I want to see the top whale buyers and sellers and the net flow.

## When to prefer this

Choose this endpoint when you need real-time on-chain trade intelligence for a specific ERC-20 token on Ethereum Mainnet, specifically from Uniswap v3 WETH/USDC pools. It is ideal for whale monitoring, sentiment analysis via net flow, or identifying large individual transactions by wallet. Prefer it over generic DEX screeners when you need wallet-level attribution and structured buy/sell summaries for agent-driven trading decisions or alerts.

## Known failure modes

- Invalid or non-Ethereum token address returns an error or empty result
- Token has no WETH/USDC Uniswap v3 pools — returns empty trades with a note
- minutes parameter outside 5–240 range may be capped or rejected
- No trades in the window returns summary with zeroes and empty arrays
- Payment failure (402) if x402 USDC payment not provided
- Rate limiting or node unavailability may cause transient 5xx errors

## How this service works

Whale and large-trade tracker for an ERC-20 on Ethereum: every buy and sell in the last N minutes on the token's deepest WETH/USDC pools (Uniswap v3), with USD size, side, wallet and transaction for the largest trades, buy/sell volume and net flow, and the wallets that bought or sold the most.

## Output

A JSON object containing: token metadata (symbol, address, decimals), the query window (from/to timestamps, block range, minutes), a summary (buy count, sell count, total trades, buy volume USD, sell volume USD, net flow USD, largest trade USD), a list of large individual trades (with tx hash, DEX, USD size, side, block, wallet, approx time), top buyer wallets ranked by USD bought, top seller wallets ranked by USD sold, and the current ETH/USD price. Notes clarify that only the 3 deepest WETH/USDC Uniswap v3 pools are included.

## 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-erc-20-whale-large-trade-tracker-4ef9c96b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from onchaincheck.dev](https://www.zero.xyz/host/onchaincheck.dev/llms.txt)