Skip to content
FalsifyLab FalsifyLab Alpha MCP

polymarket_whale_positions

polymarket_whale_positions

Top Polymarket wallets ranked by all-time profit. Their active open positions, score, and win-rate.

Signature

polymarket_whale_positions({
  min_profit?: number,     // USD, default 100_000
  min_win_rate?: number,   // 0-1, default 0.55
  min_score?: number,      // 0-1, default 0.40
  category?: "politics" | "sports" | "crypto" | "all",
  limit?: number,          // 1-50, default 10
})

Returns

[
  {
    "wallet": "0x...",
    "ens": "alpha.eth",
    "profit_all_time_usd": 482_000,
    "win_rate": 0.68,
    "n_resolved_markets": 142,
    "score": 0.71,
    "score_breakdown": {
      "profit": 0.40,
      "win_rate": 0.30,
      "activity": 0.15,
      "bet_size": 0.15
    },
    "active_positions": [
      {
        "market_slug": "trump-wins-2028-election",
        "market_question": "Will Trump run and win 2028?",
        "side": "YES",
        "shares": 12_500,
        "avg_price": 0.42,
        "current_price": 0.48,
        "unrealized_pnl_usd": 750
      }
    ]
  }
]

Example agent prompt

“show me top 5 Polymarket whales with score >0.7 and their active positions on crypto markets.”

Why this exists

Polymarket whale tracking is a copy-trade strategy. Wallets with consistent profit + high win-rate are more likely to be right on the next bet. The scoring formula:

score = 0.40*profit_norm + 0.30*win_rate + 0.15*activity + 0.15*bet_size

Surfaces wallets that are profitable AND active AND betting meaningfully (not lucky one-shots).

Powers the WhaleFollow copy-trading layer in the Polymarket Alpha bot.

Free tier

24h cached, 10 wallets, no position detail. Good for daily “who’s hot” check.

Pro tier

Real-time (15min refresh). 100 wallets. Full position detail. 90-day score history per wallet for backtesting copy strategies.

See also