Polymarket Whale Tracker & Smart Money Alerts

Monitor public Polymarket whale activity, wallet exposure, and large trades — without building your own Gamma + Data + CLOB pipeline. This Actor turns public Polymarket data into structured JSON for research workflows, scheduled monitoring, dashboards, and AI-agent pipelines.

Informational data only. This Actor surfaces public Polymarket data and computed analytics. It does not provide financial advice, trading recommendations, buy/sell signals, or profit guarantees.

Use this Actor if you are:

• A researcher or analyst studying public wallet behavior and market activity
• A quant team or AI agent builder that needs structured JSON from Polymarket APIs
• An operator who wants scheduled/polled large-trade checks without running a custom pipeline
• A journalist or market observer looking for reproducible public data workflows

Core workflow: discover → deep dive → monitor

Step	Goal	Actor mode	Minimum input	PPE cost
1	Discovery: find active/high-volume markets with whale-heavy research signals	bulk_scan	category, maxMarkets, whaleThreshold	$1.50 / scan
2	Deep dive: analyze a known Polymarket event/market context	market_analysis	eventSlugs	$0.15 / market
3	Scheduled monitoring: poll known condition IDs for large trades	alert_check	marketConditionIds, tradeAlertThreshold	$0.05 / check

Supporting workflows

Workflow	Actor mode	Use case	PPE cost
Wallet profile	whale_profile	Research active positions, P&L, win rate, ROI, and recent public activity for provided wallet addresses	$0.25 / wallet
Advanced whale discovery	whale_discovery	Discover candidate whale wallets across active markets and summarize cross-market exposure	$1.50 / scan via bulk_scan PPE event

Copy-paste first runs

1) Discovery — find whale-heavy markets

{
  "mode": "bulk_scan",
  "category": "politics",
  "maxMarkets": 5,
  "whaleThreshold": 50000,
  "includeOrderbook": false,
  "includeTradeFlow": true,
  "enableMlAnalysis": false
}

Expected result: a bounded scan of active markets in the selected category, with market health, holder/whale context, trade-flow context, and condition IDs you can reuse for deeper analysis or scheduled checks.

2) Deep dive — analyze a known event slug

{
  "mode": "market_analysis",
  "eventSlugs": ["presidential-election-winner-2028"],
  "topHoldersCount": 20,
  "includeOrderbook": true,
  "includeTradeFlow": true,
  "enableMlAnalysis": false
}

Expected result: market-by-market analysis for the event slug, including holder concentration, whale metrics, trade flow, orderbook context, and reusable condition IDs.

Copy note: market_analysis is charged per market analyzed within the selected event output.

3) Scheduled monitoring — poll known condition IDs

{
  "mode": "alert_check",
  "marketConditionIds": ["0xYOUR_CONDITION_ID"],
  "tradeAlertThreshold": 10000,
  "timeWindow": "24h"
}

Expected result: each scheduled run checks selected market condition IDs for trades above your threshold.

Copy note: this is Apify schedule-based polling/monitoring, not a streaming push-notification system.

Wallet profile — research a provided wallet

{
  "mode": "whale_profile",
  "walletAddresses": ["0xYOUR_WALLET_ADDRESS"],
  "timeWindow": "30d",
  "enableMlAnalysis": false
}

Expected result: active positions, historical P&L, win rate, ROI, and recent public activity for the wallet addresses you provide.

Advanced whale discovery — cross-market wallet research

{
  "mode": "whale_discovery",
  "category": "politics",
  "maxMarkets": 5,
  "whaleThreshold": 50000,
  "maxWhales": 10,
  "minWinRate": 0.5,
  "minPnl": 0,
  "enableMlAnalysis": false
}

Expected result: a summary object with candidate wallet profiles, active cross-market positions, exposure summaries, hot markets where multiple wallets overlap, and run metadata.

Why this Actor

	Raw Polymarket API pipeline	This Actor
Setup	Build and maintain Gamma + Data + CLOB integration	One Actor run
First question	Which API endpoint should I call?	Which workflow do I need?
Discovery	Manual joins and ranking	bulk_scan workflow
Deep dives	Separate market, holder, orderbook, and trade calls	market_analysis workflow
Wallet research	Separate profile/position/activity calls	whale_profile workflow
Large-trade monitoring	Custom polling job	alert_check workflow via Apify schedules
Output	Raw responses	Structured JSON with computed analytics

Actor modes

bulk_scan — Discovery workflow

Use this as the recommended first run. It scans active markets by category and returns structured market analytics you can use to shortlist markets for further research.

Minimum input: category, maxMarkets, whaleThreshold
Cost: $1.50 per scan

market_analysis — Deep dive workflow

Use this when you already know an event slug and want a deeper breakdown: top holders, whale sentiment, trade flow, orderbook depth, impact simulation, market health, and optional ML insights.

Minimum input: eventSlugs
Cost: $0.15 per market

alert_check — Scheduled monitoring workflow

Use this for scheduled/polled monitoring of known markets. Each run checks a lookback window for trades above your tradeAlertThreshold.

Minimum input: marketConditionIds, tradeAlertThreshold
Cost: $0.05 per check

whale_profile — Wallet profile workflow

Use this when you already have a wallet address from a Polymarket profile, prior Actor output, or your own dataset.

Minimum input: walletAddresses
Cost: $0.25 per wallet

whale_discovery — Advanced whale discovery workflow

Use this when you want the Actor to scan multiple active markets, identify candidate whale wallets from top-holder data, and summarize cross-market exposure for research.

Minimum input: category, maxMarkets, whaleThreshold
Optional filters: minWinRate, minPnl, maxWhales
Cost: $1.50 per scan via the bulk_scan PPE event

---

Input Parameters

Parameter	Type	Default	Required	Description
mode	string	bulk_scan	Yes	One of bulk_scan, market_analysis, alert_check, whale_profile, whale_discovery
eventSlugs	string[]	[]	For market_analysis	Event slugs from Polymarket URLs, e.g. presidential-election-winner-2028
marketConditionIds	string[]	[]	For alert_check	Hex condition IDs for scheduled/polled monitoring
walletAddresses	string[]	[]	For whale_profile	Wallet addresses to profile, e.g. 0xd04d93...
category	string	all	No	Category filter for bulk_scan and whale_discovery: politics, crypto, sports, pop-culture, business, science, or all
whaleThreshold	integer	50000	No	Minimum USD position value used to flag whale-heavy signals ($1K–$10M)
tradeAlertThreshold	integer	10000	For alert_check	Minimum USD trade size to flag as a large trade ($1K–$1M)
timeWindow	string	24h	No	Lookback window: 1h, 6h, 24h, 7d, 30d
includeOrderbook	boolean	true	No	Include CLOB orderbook depth and impact simulation where supported
includeTradeFlow	boolean	true	No	Include directional trade-flow analysis where supported
topHoldersCount	integer	20	No	Number of top holders to analyze per market (5–100)
maxMarkets	integer	5	No	Number of markets to scan in bulk_scan or whale_discovery (1–50)
minWinRate	number	0.5	No	Optional whale_discovery filter for wallets with resolved trade history
minPnl	number	0	No	Optional whale_discovery historical P&L filter
maxWhales	integer	10	No	Optional whale_discovery result limit (1–50)
enableMlAnalysis	boolean	false	No	Enable optional local ML-powered analysis
mlFeatures	object	{}	No	Toggle individual ML features when ML analysis is enabled

How to find event slugs

1. Go to polymarket.com.
2. Click any event, for example “Presidential Election Winner 2028”.
3. Copy the slug from the URL: https://polymarket.com/event/presidential-election-winner-2028 → presidential-election-winner-2028.

How to find wallet addresses

1. Go to a Polymarket market page or trader profile.
2. Copy the wallet address from a profile URL such as https://polymarket.com/profile/0xd04d93....
3. Paste it into walletAddresses for the Wallet Profile workflow.

How to find condition IDs for Scheduled Monitoring

Each Polymarket market has a hex condition ID. You can get it from market_analysis, bulk_scan, existing Actor output, or Polymarket API responses. Use condition IDs with alert_check and Apify schedules for recurring checks.

---

Output examples

bulk_scan output

{
  "question": "Will Candidate X win the election?",
  "slug": "example-election-market",
  "conditionId": "0xYOUR_CONDITION_ID",
  "volume24hr": 11503957.55,
  "healthScore": 65,
  "topHolderCount": 20,
  "whaleSentimentScore": 42,
  "metadata": {
    "generatedAt": "2026-05-22T13:42:17.227Z",
    "mode": "bulk_scan"
  }
}

Note: when ML is disabled (default), bulk_scan returns a flat array of market objects. When ML is enabled with statistical enhancement, the output may include additional mlInsights data.

whale_profile output

{
  "wallet": "0xd04d93be590ded67b99f053d4b6d29d3f8483312",
  "summary": {
    "winRate": 0.65,
    "totalPnl": 12500.75,
    "roi": 0.34,
    "resolvedTrades": 42,
    "activePositionValue": 12450.75,
    "activePositionCount": 100
  },
  "activePositions": [
    {
      "conditionId": "0x098e2be3df8ab529940c567819f8ef007cf...",
      "size": 519292.67,
      "avgPrice": 0.4999,
      "currentValue": 778.94,
      "cashPnl": -258844.55,
      "title": "Will Australia win the 2026 FIFA World Cup?",
      "outcome": "Yes"
    }
  ],
  "metadata": {
    "generatedAt": "2026-05-22T13:38:18.355Z",
    "mode": "whale_profile"
  }
}

alert_check output

{
  "conditionId": "0x2d3c4fc5cde6dfb43448402b912e41bd...",
  "newLargeTrades": 1,
  "totalVolume": 26387.2,
  "trades": [
    {
      "proxyWallet": "0xd04d93be590ded67b99f053d4b6d29d3f8483312",
      "size": 26600,
      "price": 0.992,
      "timestamp": "2026-05-22T13:40:54.000Z",
      "title": "Will Eric Trump win the 2028 US Presidential Election?"
    }
  ],
  "metadata": {
    "generatedAt": "2026-05-22T13:41:20.560Z",
    "mode": "alert_check"
  }
}

whale_discovery output

{
  "whales": [
    {
      "profile": {
        "address": "0xYOUR_WALLET_ADDRESS",
        "tier": "whale",
        "totalAmount": 250000,
        "marketsCount": 3,
        "winRate": 0.62,
        "roi": 0.18,
        "totalPnl": 4500,
        "resolvedTrades": 21
      },
      "positionSummary": {
        "totalPositionValue": 120000,
        "activeMarkets": 4,
        "yesExposure": 70000,
        "noExposure": 50000
      }
    }
  ],
  "hotMarkets": [],
  "metadata": {
    "generatedAt": "2026-05-22T13:45:00.000Z",
    "mode": "whale_discovery",
    "marketsScanned": 5,
    "uniqueWhalesFound": 12,
    "qualifiedWhales": 3
  }
}

---

Computed metrics explained

Smart Money Consensus

Measures the distribution of top-holder capital across YES vs NO outcomes. The labels are descriptive research classifications, not recommendations.

YES Ratio	Label
> 70%	strong_bullish
55–70%	moderate_bullish
45–55%	neutral
30–45%	moderate_bearish
< 30%	strong_bearish

Whale Sentiment Score (-100 to +100)

Net directional exposure from whale traders. Positive means more YES-side exposure and negative means more NO-side exposure. Treat it as a research metric, not as financial advice.

Market Health Score (0–100)

Combines liquidity, spread, volume, holder concentration, and recent market activity into a single market-quality score.

Orderbook impact simulation

When includeOrderbook is enabled, the Actor can estimate how hypothetical $10K, $50K, or $100K orders may move the visible CLOB orderbook.

Optional ML insights

Set enableMlAnalysis: true to add local ML-powered analysis where supported. ML runs inside the Actor environment and does not call an external AI API. Any generated text is informational research context only.

---

Pricing

This Actor uses Apify Pay Per Event pricing.

Mode / workflow	Price	Use case
Discovery (bulk_scan)	$1.50 / scan	Find active markets and reusable condition IDs
Deep dive (market_analysis)	$0.15 / market	Deep market-by-market analysis
Scheduled monitoring (alert_check)	$0.05 / check	Scheduled/polled large-trade checks
Wallet profile (whale_profile)	$0.25 / wallet	Profile active positions, P&L, win rate, ROI, and recent public activity
Advanced whale discovery (whale_discovery)	$1.50 / scan via bulk_scan PPE event	Discover candidate wallets and cross-market exposure summaries

Cost-control tips:

• Start with bulk_scan using maxMarkets: 5.
• Deep dive only the event slugs that need more context.
• Use alert_check for recurring checks once you know the condition IDs you care about.

---

API usage examples

Python — Discovery workflow

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("jy-labs/polymarket-whale-tracker").call(run_input={
    "mode": "bulk_scan",
    "category": "politics",
    "maxMarkets": 5,
    "whaleThreshold": 50000,
})

items = list(client.dataset(run["defaultDatasetId"]).iterate_items())
print(items[:3])

JavaScript — Wallet Profile workflow

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('jy-labs/polymarket-whale-tracker').call({
    mode: 'whale_profile',
    walletAddresses: ['0xYOUR_WALLET_ADDRESS'],
    timeWindow: '30d',
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items[0]);

cURL — Scheduled monitoring workflow

curl "https://api.apify.com/v2/acts/jy-labs~polymarket-whale-tracker/runs?token=***" \
  -H 'Content-Type: application/json' \
  -d '{
    "mode": "alert_check",
    "marketConditionIds": ["0xYOUR_CONDITION_ID"],
    "tradeAlertThreshold": 10000,
    "timeWindow": "24h"
  }'

For recurring checks, create an Apify Schedule that runs the same alert_check input periodically.

---

FAQ

Is this a scraper?
No browser automation is required. The Actor cross-references public Polymarket Gamma, Data, and CLOB APIs and returns structured JSON.

Which workflow should I start with?
Start with Discovery (bulk_scan) if you do not know which market to inspect yet. Use Deep dive (market_analysis) when you already have an event slug, Scheduled monitoring (alert_check) when you already know condition IDs, and Wallet profile (whale_profile) when you already have wallet addresses.

Does Scheduled monitoring send push notifications?
No. alert_check is designed for scheduled/polled monitoring. Use Apify schedules, integrations, or your own downstream automation to decide how to notify your team.

Do I need a Polymarket account?
No Polymarket login is required for the public data used by this Actor.

Can AI agents use it?
Yes. The input is simple JSON and the output is structured JSON, so AI agents can call the Actor through Apify API/MCP workflows and reason over the result.

Is this financial advice?
No. The Actor provides informational data and computed analytics only. It does not recommend trades or predict market outcomes.

---

Legal Disclaimer

This Actor provides informational data only and does not constitute financial advice. The computed metrics, whale activity signals, ML-generated insights, and sentiment scores are derived from publicly available data and are intended for research and informational purposes only. Past patterns in whale trading behavior are not indicative of future market outcomes. Trading in prediction markets involves risk of financial loss. Users are solely responsible for any decisions made based on this data.