Polymarket Market Data & Whale Tracker

Live Polymarket prediction market data — active markets with prices/volumes, full price history, and whale wallet tracking — refreshed automatically every 15 minutes.

What this actor does

Queries a production PostgreSQL database populated automatically from Polymarket's CLOB data API. Identifies "whale" wallets (traders with large positions), tracks their open bets, and exposes full market price history.

Use cases:

• Copy trading: Follow the biggest wallets before they move the price
• Anomaly detection: Spot when whale concentration spikes before a resolution event
• Market research: Download full price history for any market for backtesting
• Portfolio analysis: Audit any wallet's complete Polymarket position book

---

Actions

list_markets (default)

Returns active Polymarket markets sorted by volume, with live prices, bid/ask spread, and AI-generated category tags.

Inputs:

Field	Type	Default	Description
limit	number	100	Max records to return
isActive	boolean	true	Filter to only open (unresolved) markets
minVolume	number	—	Minimum total USDC volume
category	string	—	Macro category filter: crypto, politics, sports, pop_culture, science_tech, economy, geopolitics, entertainment, other
subCategory	string	—	Partial-match sub-category filter (e.g. bitcoin)

Example output record:

{
  "id": "553861",
  "question": "Will the Indiana Pacers win the 2026 NBA Finals?",
  "event_title": "2026 NBA Champion",
  "macro_category": "sports",
  "sub_category": "NBA",
  "last_trade_price": 0.12,
  "best_bid": 0.11,
  "best_ask": 0.13,
  "spread": 0.02,
  "volume_total": 182400.00,
  "volume_24h": 3200.00,
  "price_change_24h": -0.01,
  "is_active": true,
  "end_date": "2026-06-30T00:00:00.000Z"
}

---

market_detail

Full metadata and latest snapshot for a single market.

Inputs:

Field	Type	Required	Description
marketId	string	✅	Numeric market ID (find with list_markets)

Example output:

{
  "id": "553861",
  "condition_id": "0xe492ad9...",
  "question": "Will the Indiana Pacers win the 2026 NBA Finals?",
  "description": "Resolves Yes if the Pacers win the 2026 NBA Finals...",
  "outcomes": ["Yes", "No"],
  "is_binary": true,
  "macro_category": "sports",
  "last_trade_price": 0.12,
  "volume_total": 182400.00,
  "is_active": true,
  "end_date": "2026-06-30T00:00:00.000Z"
}

---

market_history

Full price time series for a single market (one record per 6h collection run).

Inputs:

Field	Type	Required	Description
marketId	string	✅	Numeric market ID
from	string	—	ISO 8601 start date filter
to	string	—	ISO 8601 end date filter
limit	number	—	Max records

Example output record:

{
  "captured_at": "2026-03-10T12:00:00.000Z",
  "last_trade_price": 0.14,
  "best_bid": 0.13,
  "best_ask": 0.15,
  "volume_24h": 2800.00,
  "is_active": true
}

---

whale_list

Returns whale wallets ranked by total trading volume.

Inputs:

Field	Type	Default	Description
limit	number	50	Max wallets to return

Example output record:

{
  "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,
  "is_whale": true,
  "last_movement_at": "2026-03-13T18:22:00.000Z"
}

---

whale_positions

Open net positions for a specific whale wallet.

Inputs:

Field	Type	Required	Description
walletAddress	string	✅	Proxy wallet address (0x…)

Example output record:

{
  "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",
  "market_title": "Will ETH close above $3000 on Apr 1?"
}

---

whale_history

Daily trade timeline for a whale wallet.

Inputs:

Field	Type	Default	Description
walletAddress	string	✅	Proxy wallet address
days	number	30	Lookback window in days (max: 365)

Example output record:

{
  "trade_date": "2026-03-10T00:00:00.000Z",
  "trade_count": 12,
  "buy_volume_usdc": 45200.00,
  "sell_volume_usdc": 12800.00,
  "net_flow_usdc": 32400.00
}

---

market_whales

All whale positions concentrated in one market. Useful for detecting one-sided concentration before resolution.

Inputs:

Field	Type	Required	Description
marketId	string	✅	Numeric market ID

Example output record:

{
  "proxy_wallet": "0xead152...",
  "outcome_name": "Yes",
  "net_size_usdc": 54098.00,
  "avg_entry_price": 0.53,
  "market_title": "Will ETH close above $3000 on Apr 1?"
}

---

Input schema reference

Parameter	Type	Default	Description
action	string	list_markets	Action to perform (see above)
marketId	string	—	Numeric market ID for market_detail, market_history, market_whales
walletAddress	string	—	Wallet address for whale_positions, whale_history
limit	number	—	Max records to return
isActive	boolean	true	Active markets only filter (list_markets)
minVolume	number	—	Minimum USDC volume filter (list_markets)
category	string	—	Macro category filter (list_markets)
subCategory	string	—	Sub-category partial match (list_markets)
from	string	—	ISO 8601 start date filter (market_history)
to	string	—	ISO 8601 end date filter (market_history)
days	number	30	Lookback days (whale_history)
apiKey	string	—	Optional API key for Pro tier

---

Architecture

Polymarket CLOB API (data-api.polymarket.com)
         │ collected every 15 min (automated)
         ▼
    n8n Automation Workflows (14 total)
    ├── Market Data Collector  → pm_markets, pm_market_snapshots
    ├── Whale Identifier       → pm_raw_trades, pm_whale_wallets,
    │                            pm_whale_active_positions
    └── API Endpoints (7 webhooks, tier-aware)
         │
         ▼
    PostgreSQL Database
    (~200k rows: markets, snapshots, trades, whale positions)
         │
         ▼
    Backend API (private endpoint, injected at runtime)
         │
         ▼ (this actor)
    Apify Dataset

The backend endpoint URL is stored as a server-side environment variable (API_BASE_URL) and is never exposed in actor code, logs, or user-facing configuration. Users interact only with this actor's public interface.

---

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 18, ESM)

---

License

Apache 2.0