How I Built a Polymarket Whale Tracker API in 30 Days

I lost money on a Polymarket market I was confident about. A week later I found out that three wallets had collectively moved $800K to the opposite side — two days before the resolution.

That was the moment I decided to build something.

What is a "whale" on Polymarket?

Polymarket is a prediction market where you bet real USDC on outcomes. A whale is a wallet that moves large amounts — typically $10,000+ per trade. These wallets are often:

•Insiders with non-public information
•Sophisticated quant traders with better models
•Market makers managing positions

When a whale moves, the market often follows. The problem: this information is public on-chain, but almost nobody is watching it systematically.

The Stack

Here's what I ended up with after 30 days:

•Apify actor — scrapes Polymarket on-chain activity and identifies wallet clusters above a configurable threshold
•Knowledge base aggregator — merges the last 20 actor runs into a single deduplicated dataset, summing volumes and keeping the freshest timestamps per wallet
•Mistral AI — receives a structured context (top wallets, pure buyers/sellers, hourly activity) and answers natural-language questions
•REST API — exposes the raw whale data with API key authentication and plan-based rate limits

The key insight was treating each Apify run as a snapshot and merging them into a cumulative knowledge base. A whale that moved $50K three weeks ago and $200K last night shows total_volume_usdc: $250K — you see the full picture.

The Data Model

Each record in the knowledge base represents one wallet:

{
  "proxy_wallet": "0x2a2c53bd...",
  "total_volume_usdc": "298254.85",
  "buy_volume_usdc": "298254.85",
  "sell_volume_usdc": "0.00",
  "total_trades": 7,
  "last_movement_at": "2026-04-14T04:24:15.000Z"
}

A wallet with sell_volume_usdc: 0 is a pure buyer — it has never sold. That's a strong directional signal.

What the API Returns Today

The whale_list action returns all active whale wallets sorted by total volume, straight from the actor's dataset. Each record carries the wallet address, total and buy/sell volume, trade count, and last-movement timestamp.

You can pull it with a single call to the Apify actor:

curl -s -X POST \
  "https://api.apify.com/v2/acts/N5u8wVgS1bKzibZdf/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action":"whale_list","limit":100}'

What's Next

•Webhook support (notify your bot when a wallet moves above a threshold)
•Per-market breakdown (which whales are on which specific markets)
•Historical delta tracking (compare snapshots over time to detect new entries)

If you're building a Polymarket trading bot, a dashboard, or just want to know what the smart money is doing — check out the API.

The first 5 questions are free. No card required.