Polymarket Whale Tracker — Trader

The richest Polymarket whale data, near real time. Everything the Pro tier gives — top 50 whale wallets with win rates, win/loss records and bot-likelihood flags, full wallet positions, market-whale concentration, complete 365-day price history — but refreshed every ~15 minutes. The Trader tier key is built in (no API key to manage) and there's no subscription — you pay only per call.

What this actor does

Queries a production database populated automatically from Polymarket's CLOB data API. It identifies "whale" wallets (traders with large positions), tracks their open bets, and exposes full market price history. This is the Trader edition: the same rich data as Pro, on a ~15-minute refresh — built for following whale moves close to real time. Trader-tier access is baked in, so there's no API key to paste.

Use cases:

• Near-real-time copy trading: catch whale entries within minutes, not hours
• Anomaly detection: spot whale concentration spikes as they form
• Market research: download full price history for any market for backtesting
• Portfolio analysis: audit any wallet's complete Polymarket position book

---

Why Trader — richest data, freshest refresh

The free/anonymous level is a teaser: top 10 wallets, position summaries, and 7 days of history. Trader gives you the full picture, updated the fastest:

	Free level	Pro	Trader (this actor)
Whale list	top 10, volume only	top 50 + win rate & bot flag	top 50 + win rate & bot flag
Whale positions	summary only	full breakdown	full breakdown
market_whales	🔒 locked	✅	✅
Whale history	last 7 days	up to 365 days	up to 365 days
Data freshness	every ~6h	every ~2h	every ~15 min

If a ~2-hour refresh is enough for you, the Pro edition covers the same rich data at a lower per-call price.

---

Pricing — pay per call, no subscription

This actor uses pay-per-event: you're charged per data request — one successful API call = one event. No monthly subscription and no API key to buy. The exact per-call price (and any discount for your Apify plan tier) is shown on this page; you only pay for the calls you actually run.

Prefer anonymous Bitcoin billing with a personal key instead of paying through Apify? Get one at https://apimie.com/pricing.

Note on limits. This actor does not impose a practical daily cap. If an internal safety limit is ever reached, the run does not fail — it emits a single non-fatal record describing the situation (so you can detect it programmatically) and writes the same info to the run's OUTPUT.

---

Actions

Action	What it returns	Required input
list_markets (default)	Active markets sorted by volume, with prices, spread, category tags	—
market_detail	Full metadata + latest snapshot for one market	marketId
market_history	Full price time series for one market	marketId
whale_list	Top 50 wallets by volume + win rate, wins/losses, bot flag	—
whale_positions	Full open net positions for a wallet	walletAddress
whale_history	Daily trade timeline for a wallet (up to 365 days)	walletAddress
market_whales	All whale positions concentrated in one market	marketId

Common inputs: limit (max records), category / subCategory / isActive / minVolume (filters for list_markets), from / to (date window for market_history), days (lookback for whale_history, 1–365).

Example output record (whale_list):

{
  "proxy_wallet": "0x204f72f35326db932158cba6adff0b9a1da95e14",
  "total_volume_usdc": 149850.00,
  "total_trades": 312,
  "buy_volume_usdc": 92400.00,
  "sell_volume_usdc": 57450.00,
  "win_rate": 0.64,
  "wins": 41,
  "losses": 23,
  "is_likely_bot": false,
  "last_movement_at": "2026-03-13T18:22:00.000Z"
}

Example output record (whale_positions — full detail):

{
  "proxy_wallet": "0x204f72...",
  "condition_id": "0x9e145f...",
  "outcome_name": "Yes",
  "net_size_usdc": 3200.50,
  "avg_entry_price": 0.34,
  "last_trade_at": "2026-03-10T14:30:00.000Z",
  "question": "Will ETH close above $3000 on Apr 1?"
}

---

Architecture

Polymarket CLOB API (data-api.polymarket.com)
         │ collected on a schedule (automated, ~15-min refresh for Trader)
         ▼
    n8n Automation Workflows  →  PostgreSQL
         │
         ▼
    apimie middleware (auth, tiering & rate limits)
         │
         ▼ (this actor — Trader key baked in server-side)
    Apify Dataset

The backend endpoint URL and the Trader API key are stored as server-side environment secrets and are never exposed in actor code, logs, or user-facing configuration. Authentication, tiering, and per-call accounting are enforced by the apimie middleware.

---

Tech stack

Component	Technology
Workflow automation	n8n (self-hosted)
Database	PostgreSQL
Data collection	Polymarket CLOB API
AI categorization	Mistral / DeepSeek
Actor	Apify SDK v3 (Node.js 20, ESM)

License

Apache 2.0