# Polygon PoS Large-Trade & Whale Tracker

> Polygon PoS 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).

Returns all large buys and sells of an ERC-20 token on Polygon PoS over a configurable look-back window, with USD size, wallet, transaction, volume aggregates, and top whale wallets.

## Facts

- Endpoint: GET https://ca-tax-api-mainnet.lxtap.workers.dev/polygon/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/polygon-pos-large-trade-whale-tracker-05c1f2d5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0hKNzegkUKGji9uKJjaBx

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-large-trade-whale-tracker-05c1f2d5
```

Example prompt: Pull all trades over $5,000 for the Polygon token at 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174 in the last 90 minutes and show me the top whale wallets buying and selling.

## When to prefer this

Choose this endpoint when you need real-time whale and large-trade surveillance specifically on Polygon PoS for a token traded on Uniswap v3 WPOL/USDC pools — especially when you want both individual trade-level detail (wallet, tx hash, USD size) and aggregate net flow metrics in a single call. Prefer it over generic DEX APIs when Polygon PoS chain specificity and the combined whale-ranking plus volume-summary output are required.

## Known failure modes

- Invalid or non-checksummed token address returns a validation error
- Token with no Uniswap v3 WPOL/USDC liquidity pool returns empty results
- minutes parameter outside 5–240 range is rejected
- limit parameter outside 1–40 range is rejected
- Network congestion or RPC node downtime may cause delayed or failed responses
- Token has pools but no trades above minUsd threshold returns empty trade list

## 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 individual large trades (buy or sell) with USD size, side, wallet address, and transaction hash; aggregate buy volume, sell volume, and net flow over the window; and a ranked list of the wallets that bought or sold the most, all sourced from Uniswap v3 WPOL/USDC pools on Polygon PoS.

## 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-large-trade-whale-tracker-05c1f2d5/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)