# Arbitrum One ERC-20 Large-Trade & Whale Tracker

> Arbitrum One ERC-20 Large-Trade & Whale 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-30).

Returns whale and large-trade data for an ERC-20 token on Arbitrum One, including individual trades, buy/sell volumes, net flow, and top buyer/seller wallets over a configurable time window.

## Facts

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

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

Example prompt: Show me all trades over $2000 for ARB token (0x912CE59144191C1204E64559FE8253a0e49E6548) on Arbitrum in the last 90 minutes — I want to see the biggest buyers and sellers and the overall buy vs sell volume.

## When to prefer this

Use this endpoint when you need real-time whale and large-trade intelligence specifically for an ERC-20 on Arbitrum One via Uniswap v3 WETH/USDC pools. It is the right choice when you need per-wallet attribution, net flow direction, and individual trade details in one call. Prefer it over generic block explorers when you want structured, pre-aggregated buy/sell analytics rather than raw transaction data. Not suitable for tokens that trade primarily on other DEXes, other chains, or pairs other than WETH/USDC.

## Known failure modes

- Invalid or non-ERC-20 token address returns error or empty results
- Token with no Uniswap v3 WETH/USDC pools on Arbitrum returns zero trades
- Minutes parameter outside 5-240 range may be rejected or capped at ~50 minutes (12,000 blocks)
- Limit parameter outside 1-40 range may be rejected
- Network or RPC errors on Arbitrum One may cause timeouts
- Very new tokens with no trading history return empty trade lists

## How this service works

Whale and large-trade tracker for an ERC-20 on Arbitrum One: 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

Returns a JSON object with: token metadata (symbol, address, decimals), the actual time window and block range covered, a summary of total buys/sells/trades, buy volume USD, sell volume USD, net flow USD, and largest trade USD. Also includes an ordered list of top buyer wallets and top seller wallets with per-wallet trade count, bought/sold/net USD. Individual large trades list each trade with transaction hash, DEX, USD size, buy/sell side, block, wallet, and approximate timestamp. Includes ETH/USD price used and notes on pool coverage.

## 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 Arbitrum One"
      },
      "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": "arbitrum",
  "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": "ARB",
   "address": "0x912CE59144191C1204E64559FE8253a0e49E6548",
   "decimals": 18
  },
  "window": {
   "to": "2026-10-22T16:23:07.000Z",
   "from": "2026-10-22T15:33:07.000Z",
   "minutes": 50,
   "toBlock": 517276399,
   "fromBlock": 517264399,
   "requestedMinutes": 60
  },
  "summary": {
   "buys": 298,
   "sells": 351,
   "trades": 649,
   "netFlowUsd": -2782.27,
   "buyVolumeUsd": 104130,
   "sellVolumeUsd": 106912,
   "largestTradeUsd": 3245.8
  },
  "nativeUsd": 2394.13,
  "topBuyers": [
   {
    "netUsd": 3246,
    "trades": 1,
    "wallet": "0xD118aa7a1545886e3E47FF57cF3694263d42E1d8",
    "soldUsd": 0,
    "boughtUsd": 3246
   },
   {
    "netUsd": 2240,
    "trades": 1,
    "wallet": "0x934150D353F5E53Cb6E9178456067B545a443a5D",
    "soldUsd": 0,
    "boughtUsd": 2240
   },
   {
    "netUsd": 1894,
    "trades": 1,
    "wallet": "0x4656E7359E37e33333BaA1f6d0c32D51F9ee22Cc",
    "soldUsd": 0,
    "boughtUsd": 1894
   },
   {
    "netUsd": 1652,
    "trades": 1,
    "wallet": "0xf78B2eDA7c1E20fF9906B31FE3612195BCe9D6Ce",
    "soldUsd": 0,
    "boughtUsd": 1652
   },
   {
    "netUsd": 1537,
    "trades": 1,
    "wallet": "0xEA767dB0da257a5538d7f245524a480b410aA491",
    "soldUsd": 0,
    "boughtUsd": 1537
   }
  ],
  "topSellers": [
   {
    "netUsd": -3516,
    "trades": 2,
    "wallet": "0x000FBd1e05e3b6A2465b25E5A1E682CEeda45934",
    "soldUsd": 3516,
    "boughtUsd": 0
   },
   {
    "netUsd": -2957,
    "trades": 2,
    "wallet": "0x975227fcCc2e9622C337b154Fbca1F610F8B980b",
    "soldUsd": 2957,
    "boughtUsd": 0
   },
   {
    "netUsd": -2362,
    "trades": 2,
    "wallet": "0xad2215C56Ce6a60866269d585fD7d18Ba54C6AA9",
    "soldUsd": 2362,
    "boughtUsd": 0
   },
   {
    "netUsd": -1892,
    "trades": 2,
    "wallet": "0x69F63B74597bB2B26D2CA90B30650deB9c5B3D5B",
    "soldUsd": 1892,
    "boughtUsd": 0
   },
   {
    "netUsd": -1571,
    "trades": 1,
    "wallet": "0xFD0CcF8DD9c88787305D8048969D7B7000391304",
    "soldUsd": 1571,
    "boughtUsd": 0
   }
  ],
  "largeTrades": [
   {
    "tx": "0xdd7ab46328268cad057eb9877b5a913b0ac7041b9e9fd40c109aaf98a511744e",
    "dex": "uniswap-v3",
    "usd": 3245.8,
    "side": "buy",
    "block": 517270026,
    "wallet": "0xD118aa7a
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/arbitrum-one-erc-20-large-trade-whale-tracker-4b213b52/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)