Polymarket Real-Time Data — Live Prediction-Market Intelligence

Live Polymarket market data for traders, researchers, and agents: market search, full event details, live trade tape, wallet activity, open positions, and trader profiles. Structured JSON streams to your dataset row-by-row while the run is still working — results start appearing in seconds.

⚠️ Free Apify plan notice: Free-tier accounts are limited to 2 results per run. Upgrade to any paid Apify plan for unlimited exports. This is stated here, in the Actor input form, and in the run log — it is a policy limit, not an error.

Who this is for

• Prediction-market traders tracking odds moves, spreads, and fresh markets across crypto, politics, sports, and macro
• Copy-trading and wallet-intelligence teams scoring real traders by resolved activity, not leaderboard hype
• Newsrooms and event researchers monitoring live probabilities around elections, Fed decisions, and finals
• Market makers and pricing bots watching live tape, size, and momentum per market
• AI agents & automations that need structured prediction-market data via the Apify MCP server

What you can do with it

• Discover live markets in seconds — search "bitcoin", "fed rate decision", "super bowl", or "election" and get questions, prices, volume, and liquidity instantly.
• Follow the tape — pull recent trades per market with side, size, price, outcome, and trader for flow and whale watching.
• Score real wallets — fetch full trade ledgers, live open positions with unrealized PnL, and public trader profiles to find specialists in weather, crypto, sports, or macro niches.
• Track odds over time — schedule runs and diff outcome prices, volume, and spreads for signals and alerts.
• Pipe alerts anywhere — every saved row can also POST to Slack, Discord, Zapier, Make, n8n, or your trading bot the moment it is saved.

Features

Feature	What it does	Output (featureType)
🔍 Market Search	Live keyword search across prediction markets	market_search
✨ Full Details Enrichment	Adds outcomes, prices, volume, liquidity, and event context to the same search row	market_search (detailsFetched: true)
📊 Market / Event Details	Full record for specific markets/events by slug, condition ID, or URL; optional live book snapshot	market_details
⚡ Live Market Trades	Recent tape per market — side, size, price, outcome, trader	market_trades
👛 Wallet Activity	Trade-by-trade ledger per wallet — buys, sells, redeems	wallet_activity
💼 Wallet Open Positions	Live exposure per wallet — entry, current value, unrealized PnL	wallet_positions
👤 Trader Profile	Public identity — pseudonym, volume signals, account context	wallet_profile
🔗 Scrape By URL	Direct processing of any Polymarket event, market, or profile URL	scrape_by_url

Enrichment, not filtering: when Enrich with full market details is on, every search result stays one row and gains deep fields in place (detailsFetched: true). No duplicate rows, no dropped markets — every discovered item always reaches the dataset, so your run cost stays predictable. Enrichment adds a little extra time per market.

Quick start (10 results in seconds)

The Actor comes prefilled for an instant demo run:

1. Click Start — no configuration needed.
2. Defaults: Market Search on, queries bitcoin, fed rate decision, super bowl, 10 markets per query.
3. Watch the dataset fill row-by-row in real time.

Example searches that work well

Goal	Queries	Notes
Crypto odds	bitcoin, ethereum, solana	High-volume price markets
Macro / Fed	fed rate decision, cpi, recession	Scheduled-release markets
Sports	super bowl, nba finals, world cup	Game and futures markets
Politics	election, president, senate	Long-horizon probability tracking
Culture / tech	oscars, iphone, spacex	Niche event discovery

Full input reference

🔍 Market Search (enableMarketSearch, default on)

Field	Type	Default	Notes
searchQueries	string list	3 examples	Required when search is on. Any market topic.
searchMaxResults	integer	10	Max markets per query (1–100).
searchIncludeClosed	boolean	false	Off = live tradeable markets only. On = include closed/resolved for backtests.
searchFetchFullDetails	boolean	false	Enrich with full market details — merges outcomes, prices, volume, liquidity, and event context into the same row.

📊 Market / Event Details (enableMarketDetails, default off)

Field	Type	Notes
marketSlugs	string list	e.g. bitcoin-above-on-february-23.
conditionIds	string list	Hex 0x... IDs. Shared with Live Trades.
marketUrls	string list	Full polymarket.com/event/... or /market/... URLs.
includeOrderBook	boolean	Adds a best-effort live book snapshot. Unavailable for closed markets, which still return full fields.

⚡ Live Market Trades (enableMarketTrades, default off)

Field	Type	Default	Notes
conditionIds	string list	—	Required. Hex 0x... IDs.
tradesMaxPerMarket	integer	30	Max recent trades per market (1–200).

👛 Wallet Activity (enableWalletActivity, default off)

Field	Type	Default	Notes
walletAddresses	string list	—	Required. 0x... addresses. Shared by Activity, Positions, and Profile.
activityMaxPerWallet	integer	50	Max rows per wallet (1–500).

💼 Wallet Open Positions (enableWalletPositions, default off)

Field	Type	Default	Notes
walletAddresses	string list	—	Required. Same list as Activity.
positionsMaxPerWallet	integer	50	Max positions per wallet (1–200).

👤 Trader Profile (enableWalletProfile, default off)

Field	Type	Notes
walletAddresses	string list	Required. Same list as Activity.

🔗 Scrape By URL (enableScrapeByUrl, default off)

Field	Type	Notes
scrapeUrls	string list	Any Polymarket event, market, or profile URL. Auto-detects page type.

🔔 Delivery

Field	Type	Default	Notes
webhookUrl	string	—	Optional additional push per record. Dataset write always happens first.
webhookFormat	select	json	json = full record; slack = Slack-friendly message.

🌐 Connection

Field	Type	Default	Notes
proxyConfiguration	proxy	Residential US	Residential recommended at scale.

Output field reference

Every row carries featureType, scrapedAt, and url. Filter dataset views by featureType.

• market_search: question, outcomes, outcome_prices, last_trade_price, best_bid, best_ask, spread, volume, liquidity, active, closed, end_date, event_title, tags, position, detailsFetched
• market_details: above + volume_24h, volume_1wk, volume_1mo, accepting_orders, start_date, description, resolution_source, order_book (when requested and available)
• market_trades: condition_id, question, outcome, side, price, size, usdc_size, timestamp, trader, trader_pseudonym, transaction_hash
• wallet_activity: wallet, trade_type, side, question, outcome, price, size, usdc_size, timestamp, transaction_hash
• wallet_positions: wallet, question, outcome, avg_price, current_price, current_value, cash_pnl, percent_pnl, size, redeemable
• wallet_profile: wallet, pseudonym, display_name, bio, verified, taker_tier_name, weighted_volume, created_at
• scrape_by_url: pageType + the fields of the detected type

Webhook guide

Set webhookUrl to receive each saved row as it streams:

• JSON mode: the full record object is POSTed with Content-Type: application/json.
• Slack mode: a compact message with question, price, volume, outcome, and a link back to Polymarket.
• Delivery is fire-and-forget with a 15-second timeout. Failures are logged once and never stop the run — the dataset write always succeeds first.

MCP / AI-agent usage

This Actor works with the Apify MCP server. Example questions your agent can answer:

• "Search Polymarket for bitcoin markets and show the top 5 by volume with current Yes prices."
• "Pull the last 50 trades for condition 0x… and summarize buy vs sell pressure."
• "Fetch wallet 0x…'s recent activity and open positions — what are they exposed to right now?"

Point the agent at this Actor, run it with the relevant inputs, then read the dataset views (search, trades, wallet_activity, wallet_positions).

FAQ

• Do I need to supply keys? No. Authentication is handled on the backend — you just pick features and run.
• Which proxy should I use? Residential US default. Match region only if you target region-specific availability.
• How fresh is the data? Every run collects live at execution time; each row carries scrapedAt so you can diff across scheduled runs.
• What does the free tier include? Free Apify plans get 2 results per run as a trial. Paid plans are uncapped up to your per-feature limits.
• Do closed markets work? Yes — turn on "Include closed / resolved markets" for backtests. Live book snapshots are best-effort and only available on open markets.
• Will partial results ever be dropped? No. Every discovered market, trade, and wallet entry is saved. Enrichment adds fields to the same row instead of creating a second one.