Prediction markets
The Polymarket Whale Trades Tracker is an API that scans the public Polymarket trade tape and returns every trade above a USD threshold you choose, as flat JSON records with wallet, side, outcome, price, size and transaction hash — plus a per-wallet aggregation summary showing who is accumulating what.
Capabilities
Set your own min_usd — from $100 “smart money” up to $1M+ true whales — and a lookback window up to 14 days. You define what a whale is, not the tool.
Alongside trade rows, the dataset 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.
Every row is a self-contained record — no nested blobs to unpack. Export straight to CSV, Excel, Google Sheets, or feed it to a model.
Pass a market_slug to watch the whale flow in one specific market — an election, a BTC daily window, a sports final.
{
"record_type": "trade",
"wallet": "0xd27cc742d023d06ef633a4c880cf1ff1836ec081",
"wallet_name": "madkkee",
"side": "SELL",
"outcome": "Up",
"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",
"datetime_utc": "2026-08-04T05:13:24+00:00",
"transaction_hash": "0xa02d161a6b72a718c0a9ea00ef9d..."
}{
"min_usd": 5000,
"lookback_hours": 24,
"market_slug": "",
"max_trades": 1000
}Every field is optional — the defaults scan the last 24 hours of the whole exchange at a $5,000 threshold.
Playbook
Run daily with a $5k–$25k threshold and rank the wallet summaries by net buy flow. Wallets that keep showing up with size before markets move are your copy-trading candidate pool — pipe them into the Wallet P&L Analyzer to vet them.
Watching one election or crypto market? Single-market mode gives you its whale tape: who is dumping into the favorite, who is accumulating the longshot, at what prices.
Schedule hourly, attach an Apify webhook, and push any trade above $50k into Slack or Discord within minutes of it printing.
Expose the actor to an LLM agent via MCP and let it answer “who is moving money on X right now?” with live, structured evidence instead of guesses.
Integration
Synchronous REST, official clients, schedules with webhooks — or expose it directly to an AI agent through the Apify MCP server. More patterns on the integrations page.
curl -X POST \
"https://api.apify.com/v2/acts/splendorous_astrolabe_xs9~polymarket-whale-trades/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
-H 'Content-Type: application/json' \
-d '{
"min_usd": 5000,
"lookback_hours": 24,
"market_slug": "",
"max_trades": 1000
}'from apify_client import ApifyClient
client = ApifyClient("<APIFY_TOKEN>")
run = client.actor("splendorous_astrolabe_xs9/polymarket-whale-trades").call(
run_input={
"min_usd": 5000,
"lookback_hours": 24,
"market_slug": "",
"max_trades": 1000
}
)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item){
"mcpServers": {
"public-signal": {
"url": "https://mcp.apify.com/?actors=splendorous_astrolabe_xs9/polymarket-whale-trades",
"headers": {
"Authorization": "Bearer <APIFY_TOKEN>"
}
}
}
}Pricing
Billed through your Apify account's usage credit. The free plan includes $5 of usage every month — no card needed to try it.
| Billable event | Price | Charged |
|---|---|---|
| Run started | $0.05 | flat fee per run |
| Whale trade | $0.002 | per large trade returned |
A 24-hour scan at a $5k threshold typically returns 100–400 trades: about $0.25–$0.85 per run.
Questions
Whatever you decide: the min_usd input sets the threshold. $5,000 is a sensible default for exchange-wide scans; drop to $500–$1,000 to include consistent smart-money size, or raise to $100,000+ for true whales only.
No. It reads Polymarket's public trade tape. You only need an Apify account to run it.
Yes — pass the market_slug of any Polymarket market and the scan is restricted to that market's tape.
Each run reads the live public tape at execution time. Schedule it every 15 minutes to a few hours depending on how fresh you need the feed; each run only bills for the trades it returns.
Feed the wallet address into the Polymarket Wallet P&L Analyzer — it reconstructs the wallet's realized P&L, win rate and hedging share from the same public tape.
Related
Paste any wallet address, get its reconstructed trading record: realized P&L, win rate, per-market breakdown, hedging share — with honest coverage flags.
Structured odds, prices, volume and liquidity for exactly the markets you care about — with optional price history from the public CLOB.
A 24-hour scan at a $5k threshold typically returns 100–400 trades: about $0.25–$0.85 per run.