# Polygon PoS ERC-20 Large-Trade & Whale Tracker

> Polygon PoS 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 buy/sell trades, volume summary, net flow, and top whale wallets for an ERC-20 token on Polygon PoS over the last N minutes, sourced from Uniswap v3 WPOL/USDC pools.

## Facts

- Endpoint: GET https://onchaincheck.dev/polygon/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/polygon-pos-erc-20-large-trade-whale-tracker-ffb33613
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dqbTPTPL9uOcaTzDu6-zw

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 polygon-pos-erc-20-large-trade-whale-tracker-ffb33613
```

Example prompt: Pull the last 60 minutes of large trades for the LINK token at 0x53E0bca35eC356BD5ddDFebbD1Fc0fD03FaBad39 on Polygon PoS — show me any trades over $500 USD and tell me who the biggest buyers and sellers are.

## When to prefer this

Use this endpoint when you need real-time DEX trade surveillance for a specific ERC-20 on Polygon PoS, including whale wallet identification and net flow metrics from Uniswap v3 pools. Prefer this over generic block explorers when you want pre-aggregated buy/sell volume, top-wallet rankings, and USD-denominated sizing in a single call. Choose this over the Base or Arbitrum sibling endpoints specifically for Polygon PoS tokens.

## Known failure modes

- Invalid token address format returns a validation error
- Token with no liquidity in WPOL/USDC Uniswap v3 pools returns empty trade lists
- minutes parameter outside 5–240 range may be capped or rejected
- Network congestion may cause stale block data
- Token address that exists on another chain (not Polygon PoS) returns no results
- minUsd filter too high may return zero listed trades even if trading occurred

## How this service works

Whale and large-trade tracker for an ERC-20 on Polygon PoS: every buy and sell in the last N minutes on the token's deepest WPOL/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: chain and token metadata (symbol, address, decimals); the scanned block window with timestamps; a summary of total buys, sells, buy volume USD, sell volume USD, net flow USD, and largest trade USD; a list of top buyer wallets with per-wallet bought/sold/net USD and trade count; a list of top seller wallets with the same fields; a list of large individual trades with wallet, side, USD size, and transaction hash; and an array of the Uniswap v3 pools scanned.

## 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 Polygon PoS"
      },
      "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": "polygon",
  "notes": "Trades from the 3 deepest WPOL/USDC pools; other pairs and aggregator-internal routes are not counted. Wallets are transaction senders, looked up for the 40 largest trades.",
  "token": {
   "symbol": "LINK",
   "address": "0x53E0bca35eC356BD5ddDFebbD1Fc0fD03FaBad39",
   "decimals": 18
  },
  "window": {
   "to": "2026-10-22T16:23:24.000Z",
   "from": "2026-10-22T15:23:24.000Z",
   "minutes": 60,
   "toBlock": 95987222,
   "fromBlock": 95985422
  },
  "summary": {
   "buys": 20,
   "sells": 15,
   "trades": 35,
   "netFlowUsd": 145.557,
   "buyVolumeUsd": 455.848,
   "sellVolumeUsd": 310.29,
   "largestTradeUsd": 79.4717
  },
  "nativeUsd": 0.0907291,
  "topBuyers": [
   {
    "netUsd": 90.23,
    "trades": 4,
    "wallet": "0x3f6720364ACF02366a63e5F7106D314D31f688d1",
    "soldUsd": 11.93,
    "boughtUsd": 102.2
   },
   {
    "netUsd": 71.03,
    "trades": 2,
    "wallet": "0x03E7c97adA2FA30752999A859d2d2e9f1881b4C8",
    "soldUsd": 0,
    "boughtUsd": 71.03
   },
   {
    "netUsd": 59.98,
    "trades": 1,
    "wallet": "0x73bE04ABAa96c7D92Db28cD3AEF1539A77775d5b",
    "soldUsd": 0,
    "boughtUsd": 59.98
   },
   {
    "netUsd": 39.05,
    "trades": 1,
    "wallet": "0xEe8411A0AC858a8e2E2Cae069D5d45fa5978bD6d",
    "soldUsd": 0,
    "boughtUsd": 39.05
   },
   {
    "netUsd": 9.84,
    "trades": 1,
    "wallet": "0x9242966990B0B28CaF896e9fbdF048044BC7555e",
    "soldUsd": 0,
    "boughtUsd": 9.84
   }
  ],
  "topSellers": [
   {
    "netUsd": -70.5,
    "trades": 3,
    "wallet": "0xd2b648d4ceD31FB4EF142962C1d2Ea7428977F06",
    "soldUsd": 70.5,
    "boughtUsd": 0
   },
   {
    "netUsd": -37.87,
    "trades": 1,
    "wallet": "0xB9A7f2B5A0290D01188b77F35cEEf046d332a60C",
    "soldUsd": 37.87,
    "boughtUsd": 0
   },
   {
    "netUsd": -29.14,
    "trades": 1,
    "wallet": "0x96d0e9A19627903E24962c2fB8a43C728281CB4f",
    "soldUsd": 29.14,
    "boughtUsd": 0
   },
   {
    "netUsd": -0.412,
    "trades": 1,
    "wallet": "0x03d9964f4D93a24B58c0Fc3a8Df3474b59Ba8557",
    "soldUsd": 0.412,
    "boughtUsd": 0
   }
  ],
  "largeTrades": [],
  "poolsScanned": [
   {
    "dex": "uniswap-v3",
    "pool": "0x79E4240E33C121402dfc9009dE266356c91f241d",
    "pairedWith": "USDC"
   },
   {
    "dex": "uniswap-v3",
    "pool": "0x0A28C2F5E0E8463E047C203F00F649812aE67E4f",
    "pairedWith": "WPOL"
   },
   {
    "dex": "uniswap-v3",
    "pool": "0x98b9162161164De1ED182A0dFA08f5fBf0F733CA",
    "pair
… (truncated)
```

## More

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