Polymarket Whale Trades Tracker

A Polymarket whale tracker for finding out who is moving real money — right now. This Actor scans the public Polymarket trade tape and returns every large trade above your USD threshold, with a clean flat schema and a per-wallet aggregation summary so you instantly see which wallets are accumulating and what they're buying.

If you're hunting smart money — the wallets that consistently show up with size before a market moves — this is the raw feed: configurable whale threshold, per-wallet buy/sell flow, and a single-market mode for watching one event's tape.

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 (wallet, side, outcome, price, USD size, market title/slug, timestamp, tx hash). No nested blobs to unpack; export straight to CSV/Excel/Sheets.
• Per-wallet aggregation built in — the dataset also contains wallet_summary rows: total USD flow, buy vs sell split, net direction, distinct markets, largest trade. The run's OUTPUT record includes the top-10 wallets, ready for alerting.
• Single-market mode — pass a market_slug to watch the whale flow in one specific market (e.g. an election or a BTC daily market).

What you get

Trade rows (record_type: "trade"):

{
  "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"
}

Wallet summary rows (record_type: "wallet_summary"), sorted by total USD:

{
  "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"
}

Filter on record_type to get only trades or only summaries.

Input

Field	Default	Description
min_usd	5000	Minimum notional trade size in USD
lookback_hours	24	How far back to scan (max 336 h / 14 days)
market_slug	—	Optional: restrict to one market
taker_only	true	One row per fill (taker side); disable to include maker side
max_trades	1000	Safety cap on returned trades

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 analyze them (pairs perfectly with a wallet P&L analyzer) 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.

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. 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.

Pricing

Pay per event: a small flat fee per run start plus a fraction of a cent per whale trade returned. A typical default run (24 h, $5k threshold) costs well under $1.