Guide
How to track Polymarket whales
Where whale-trade data actually comes from, a workflow that goes from a big number to a judgment, and the ways the tape misleads people who read it too fast.
What you are tracking
Individual fills of $1,000 or more, recorded from two sources that check each other.
Every Polymarket trade settles on the Polygon blockchain: the exchange contract emits an OrderFilled event for each fill, naming the wallet, the outcome token, the size, and the price. That log is public and permanent — anyone with a Polygon RPC endpoint can read it, and any recorded trade can be verified by its transaction hash.
Reading the chain alone is slow and shapeless, so PolyTrace listens to Polymarket’s public order-feed WebSocket for fills as they happen, keeps every fill worth $1,000 or more, and reconciles the stream against the on-chain OrderFilled logs — the chain is the authority, the feed is the speed. Duplicate deliveries are dropped on transaction hash, and gaps in the stream are backfilled from the logs afterwards, so the record converges on what the chain says even when the feed hiccups.
The $1,000 threshold applies to a single fill, not to a position accumulated over several trades, and it is a fixed dollar amount rather than a percentile — the bar does not move when the market gets busier. The full rules live in the methodology.
The workflow
Five steps, from raw tape to something worth acting on — or ignoring.
- 1. Watch the tape. The live feed lists every qualifying fill as it settles: wallet, direction, outcome, size, price. The whale tracker page adds current totals and the top-rated wallets around the same tape.
- 2. Cut what you don’t care about. Sports and esports markets usually produce the largest share of qualifying trades, and most of that flow is routine in-game money. Filter by category and raise the minimum size until what remains is worth reading one row at a time.
- 3. Read the trade against its market. A $50,000 buy at 95¢ is a near-certainty parked; the same size at 20¢ is a strong claim. Every trade links to its market page, where it sits next to the market’s other whale flow — all tracked markets rank by that flow.
- 4. Read the wallet, not the trade. The wallet’s page carries its PnL, win rate with the sample behind it, volume, and breadth. A big trade from a measurably strong wallet and the same trade from an unknown are different facts. How to weigh those figures is its own guide: how to evaluate a Polymarket wallet.
- 5. Zoom out weekly. Single trades are noisy; the weekly whale reports aggregate the same data into where the money actually went, which is the view most single-trade impressions do not survive.
What “live” actually means
Every layer of a tracker has its own delay. Know them.
Trades arrive over the WebSocket feed within seconds of the fill, and pages that show them are rendered at request time. Trader profiles refresh on a tiered schedule: the wallets with the largest measured PnL resync about every five minutes, quieter tiers every 15 to 30 minutes, and passive wallets as rarely as every few days. So a whale trade can appear on the tape before its wallet’s profile has caught up — PolyTrace marks those profiles as syncing rather than filling the gap with stale numbers. History converges more slowly still: feed gaps are backfilled from on-chain logs after the fact, so a day’s totals can tick up hours later.
The delay that matters most is the one after all of those: by the time a trade is on your screen, the price it moved is already moved. The entry price on the tape is the whale’s, not the one available to whoever reads about it.
How whale watching goes wrong
The failure mode is not missing trades. It is over-reading the ones you see.
- Size is not conviction. A large fill can be a hedge against a position elsewhere, an exit dressed as an entry, a rebalance, or a mistake. The tape records what happened, not why.
- The threshold cuts both ways. A large order sliced into fills under $1,000 never appears at all, and one qualifying fill may be a fragment of something much larger. Per-fill thresholds see fills, not intentions.
- Some whales are furniture. Market-making and high-frequency wallets trade both sides of the same market by design. Their fills dominate raw volume and carry no directional opinion — which is one reason wallet records matter more than single trades.
- Favorites inflate the tape. A five-figure buy at 97¢ is closer to parking cash than to a prediction. Reading it as strong new information about the event is the most common misread on any whale feed.
- Wallets are not people. Profiles key on Polymarket proxy wallets — the addresses Polymarket exposes publicly. One person can run several, and no tracker can join them. Definitions for these terms are in the glossary.
None of this is a reason not to watch — it is the reason to watch wallets rather than trades, and samples rather than highlights. Nothing here is financial advice.
Tracking without a tracker
The same pipeline, if you want to build it yourself.
Everything above can be reproduced from public infrastructure: subscribe to Polymarket’s market-data WebSocket for fills, or read OrderFilled logs from the exchange contracts through any Polygon RPC provider. The parts that take the time are not the reading but the bookkeeping — resolving outcome-token IDs back to markets and their titles, deduplicating (one market order matched against several resting orders produces several logs), distinguishing the exchange contract from the trader on each fill, and backfilling the stretches your listener was down. PolyTrace exists because that bookkeeping is most of the work; this site is the maintained version of it, and the methodology documents the choices it makes.
Where to go next
The whale tracker shows what is moving right now, and the live feed is the full tape. When a wallet catches your eye, how to evaluate a Polymarket wallet is the second half of this workflow, and the trader leaderboard ranks every wallet PolyTrace has measured.