Polymarket Whale Trades Tracker

Docs & recipes: pricing math, use-case playbooks and copy-paste API/MCP snippets · practical guide

Find out who is moving real money on Polymarket — right now. One run scans the public trade tape and returns every trade above your USD threshold (illustrative example):

{
  "record_type": "trade",
  "wallet": "0xd27cc742d023d06ef633a4c880cf1ff1836ec081",
  "wallet_name": "madkkee",
  "wallet_pseudonym": "Distant-Pomelo",
  "side": "SELL",
  "outcome": "Up",
  "outcome_index": 0,
  "price": 0.999,
  "size_shares": 7390,
  "size_usd": 7382.61,
  "market_title": "Bitcoin Up or Down on August 4?",
  "market_slug": "bitcoin-up-or-down-on-august-4-2026",
  "event_slug": "bitcoin-up-or-down-on-august-4-2026",
  "condition_id": "0x80942ae64f933f081751b480735e86e6abe437f05444e269d5c53b25430caccf",
  "timestamp": 1785858804,
  "datetime_utc": "2026-08-04T05:13:24+00:00",
  "transaction_hash": "0xa02d161a6b72a718c0a9ea00ef9d6887118c64442d2d1b21f36ba97941a8002c"
}

…plus per-wallet aggregation summaries, sorted by total USD flow, so you instantly see which wallets are accumulating and what they're buying:

{
  "record_type": "wallet_summary",
  "wallet": "0xd3bc2022...",
  "trades": 12,
  "total_usd": 184220.5,
  "buy_usd": 141002.0,
  "sell_usd": 43218.5,
  "net_buy_usd": 97783.5,
  "distinct_markets": 3,
  "largest_trade_usd": 51000.0,
  "first_seen_utc": "2026-08-03T09:12:44+00:00",
  "last_seen_utc": "2026-08-04T04:58:01+00:00"
}

If you're hunting smart money — the wallets that consistently show up with size before a market moves — this is the raw feed.

Why this tracker

• Configurable thresholds — set your own min_usd (from $100 "smart money" up to $1M+ true whales) and lookback window up to 14 days, instead of a fixed definition of "whale".
• Clean flat schema — every row is a self-contained record. No nested blobs to unpack; export straight to CSV/Excel/Sheets.
• Per-wallet aggregation built in — the run's OUTPUT record also includes the top-10 wallets, ready for alerting.
• Single-market mode — pass a market_slug to watch the whale flow in one specific market (an election, a BTC daily, …).
• Verifiable — every trade row carries the on-chain transaction_hash.

Input

Field	Default	Description
min_usd	5000	Minimum notional trade size (shares × price), USD
lookback_hours	24	How far back to scan (max 336 h / 14 days)
market_slug	— (all markets)	Optional: restrict to one market (last path segment of the polymarket.com URL)
taker_only	true	One row per fill, attributed to the aggressive side; disable to also see the passive maker side (rows may then represent the same fill twice)
max_trades	1000	Safety cap on returned trades

A zero-config {} run works: last 24 h, $5,000 threshold, all markets.

Output fields

Trade rows (record_type: "trade"): wallet, wallet_name, wallet_pseudonym, side (BUY/SELL), outcome, outcome_index, price, size_shares, size_usd, market_title, market_slug, event_slug, condition_id, timestamp (unix), datetime_utc (ISO), transaction_hash.

Wallet summary rows (record_type: "wallet_summary"): wallet, wallet_name, trades, total_usd, buy_usd, sell_usd, net_buy_usd, largest_trade_usd, distinct_markets, first_seen_utc, last_seen_utc.

Filter on record_type to get only trades or only summaries. The run's key-value OUTPUT includes the top-10 wallet summaries and a tape_capped coverage flag.

Use cases

Smart-money alerts

Schedule hourly, diff against the previous run, get pinged when a whale enters your market.

Copy-trading research

Find consistently active large wallets, then vet them with the Polymarket Wallet P&L Analyzer (same portfolio — feed it the wallet field) before deciding whether to follow.

Market microstructure and journalism

Quantify how much of a market's move was driven by a handful of wallets — every row carries the tx hash for verification.

Using from Claude / AI agents (MCP)

Add Apify's MCP server (https://mcp.apify.com) to Claude, Cursor, or any MCP-capable agent and this tracker becomes a tool your agent can call mid-conversation:

{
  "tool": "polymarket-whale-trades",
  "input": { "min_usd": 20000, "lookback_hours": 6 }
}

Ask your agent: "Any whale trades over $20k on Polymarket in the last 6 hours, and which wallets were net buyers?" — one run, and the wallet summaries answer the second half for free.

Pricing

Pay per event: $0.05 per run + $0.002 per whale trade returned. Worked math: a default run (24 h lookback, $5k threshold) typically returns 100–400 trades → $0.25–$0.85. An hourly scheduled watch at a $20k threshold usually returns a handful of trades per run — a few cents each. max_trades is your hard cost cap ($0.05 + max_trades × $0.002).

Honest limits

• The public tape paginates to a depth of roughly 3,500 matching trades per query; if your filter is so broad the cap is hit, the run reports tape_capped: true in OUTPUT so coverage is always honest — tighten min_usd, shorten lookback_hours, or use market_slug.
• "Whale" = notional per fill. A wallet splitting a large order into small fills below your threshold won't appear (the per-wallet summaries mitigate this for fills above it).
• USD sizes are share-count × price; they are not adjusted for later reversals.

Data source and fair use

Uses only Polymarket's public, unauthenticated data APIs. No login, no keys, no scraping of private data. Wallet addresses and usernames shown are already public on polymarket.com.