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 /v1/whales endpoint returns all active wallets sorted by total volume. Trader plan subscribers get data refreshed every 5 minutes. Pro plan gets 2-hour windows. Free tier gets the AI chat with 5 questions/day.

You can query it with a simple curl:

curl https://apimie.com/api/v1/whales \
  -H "Authorization: Bearer YOUR_API_KEY"

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.