📈 Polymarket Prediction Market Scraper

🚀 Pull live prediction market data in seconds. Filter by category, status, volume, or date range. No API key, no wallet, no manual CSV wrangling.

🕒 Last updated: 2026-05-16 · 📊 38 fields per record · 3,600+ categories · Live odds + volume · Optional CLOB orderbook depth

Polymarket is one of the largest decentralized prediction markets, with billions of dollars in cumulative trading volume across politics, sports, crypto, geopolitics, and pop culture. Each event groups dozens of binary "Yes/No" markets around a single question. This actor turns the live Polymarket catalog into a structured dataset of events and markets, complete with current odds, 24-hour and weekly volume, liquidity, open interest, outcome prices, and competitiveness scores. Every record comes straight from the public Gamma API, no signed wallet transactions, no rate limits to manage, no JavaScript bundle to reverse-engineer.

The output is built for analysts, traders, journalists, and researchers who need prediction-market data in flat tabular form. You pick a category (or none), a sort order, optional volume and date filters, and the scraper returns events with all child markets nested, or one row per individual market. An opt-in flag fetches the full CLOB order book per outcome token, so you can capture bid and ask depth alongside the headline prices. The result is a clean dataset that drops straight into a dashboard, a backtest, a newsletter chart, or a fine-tuning corpus, in under 30 seconds.

🎯 Target audience	💡 Primary use cases
Crypto traders, prediction-market analysts	Build trading signals from real-time market movements
Journalists and newsletter writers	Cite live sentiment data on world events
Data scientists and ML researchers	Train forecasting models with historical odds
Academic researchers in forecasting	Study prediction-market accuracy versus outcomes

---

📋 What the Polymarket Prediction Market Scraper does

• 🏷️ Category filtering. Pick from 3,600+ Polymarket category slugs, including politics, sports, crypto, geopolitics, AI, economy, weather, and culture.
• 🔍 Free-text search. Pass a search query to surface events whose titles match a keyword, ticker, or person.
• 📊 Two output shapes. Events mode returns one record per event with all child markets nested. Markets mode flattens to one row per binary Yes/No question.
• 💰 Volume and liquidity gates. Set minimum total volume or current liquidity to skip noise and focus on actively traded markets.
• 📅 Date-range filtering. Bound start and end dates to pull a specific election cycle, sports season, or resolution window.
• 📈 Optional orderbook depth. Toggle the orderbook flag to attach full CLOB bid and ask ladders for every market outcome.

Each record carries the headline title, slug, canonical Polymarket URL, image, current outcome prices, best bid and ask, last trade price, 24-hour and weekly volume, total volume and liquidity, open interest, price changes across multiple windows, a competitiveness score, category tags, resolution metadata, and a scrape timestamp. Events also include the nested array of child markets, each with the same trading fields.

💡 Why it matters: Prediction markets aggregate real money bets into a single probability for any verifiable future event. That signal is increasingly used by traders for hedging, journalists for sentiment, and ML teams for forecasting training data. Pulling it on a schedule turns a live trading venue into a structured time series.

---

🎬 Full Demo

🚧 Coming soon: a 3-minute walkthrough showing category filtering, search, markets-mode pivot, and orderbook depth in action.

---

⚙️ Input

Field	Type	Description
searchQuery	string	Free-text search across event and market titles. Leave blank to browse the full catalog.
maxItems	integer	Free users limited to 10 items. Paid users up to 1,000,000.
scrapeMode	string	events (grouped, with nested markets) or markets (one row per binary question).
tagSlugs	array<string>	One or more Polymarket category slugs. 3,600+ enumerated. Common: politics, sports, crypto, geopolitics, ai, economy.
status	string	active, closed, archived, or all.
sortBy	string	One of: volume24hr, volume1wk, volume1mo, volume1yr, volume, liquidity, openInterest, competitive, startDate, endDate, createdAt, oneDayPriceChange, oneWeekPriceChange, oneMonthPriceChange.
sortDirection	string	desc (biggest first, default) or asc.
minVolume	integer	Skip events or markets below this total USDC volume.
minLiquidity	integer	Skip events or markets below this current USDC liquidity.
startDateMin	string	ISO date or datetime. Lower bound on start date.
startDateMax	string	ISO date or datetime. Upper bound on start date.
endDateMin	string	ISO date or datetime. Lower bound on end date.
endDateMax	string	ISO date or datetime. Upper bound on end date.
includeOrderbook	boolean	If true, fetch full CLOB bid and ask depth for every market outcome.

Example: pull the 50 most-traded active politics events from the last 24 hours.

{
    "maxItems": 50,
    "scrapeMode": "events",
    "tagSlugs": ["politics"],
    "status": "active",
    "sortBy": "volume24hr",
    "sortDirection": "desc"
}

Example: search for Bitcoin-related markets with orderbook depth, flattened to one row per binary question.

{
    "maxItems": 100,
    "scrapeMode": "markets",
    "searchQuery": "bitcoin",
    "status": "active",
    "minLiquidity": 1000,
    "includeOrderbook": true
}

⚠️ Good to Know: Polymarket events often bundle dozens of child markets under one question (a 60-team World Cup winner, for example). Use events mode to keep them grouped and markets mode to pivot to one row per Yes/No question.

---

📊 Output

Each record contains live prediction-market data with the canonical Polymarket URL, current outcome prices, trading metrics across multiple time windows, category tags, and resolution metadata.

🧾 Schema

Field	Type	Example
🖼️ imageUrl	string	https://polymarket-upload.s3...
🏷️ title	string	"2026 FIFA World Cup Winner"
🔗 url	string	https://polymarket.com/event/2026-fifa-world-cup-winner-595
🆔 id	string	"30615"
🧭 slug	string	"2026-fifa-world-cup-winner-595"
🧱 type	string	"event" or "market"
🚦 status	string	"active", "closed", "archived"
📂 category	string	"Soccer"
🎯 outcomes	array	["Yes", "No"]
💵 outcomePrices	array<number>	[0.1655, 0.8345]
📥 bestBid	number	0.165
📤 bestAsk	number	0.166
💱 lastTradePrice	number	0.165
↔️ spread	number	0.001
💰 volume	number	993780015.83
📊 volume24hr	number	8821793.94
📈 volume1wk	number	78280829.18
📉 volume1mo	number	335004429.36
🗓️ volume1yr	number	985106793.01
💧 liquidity	number	234048873.36
🔒 openInterest	number	13217861.66
⏱️ oneDayPriceChange	number	0.015
📆 oneWeekPriceChange	number	0.012
🗒️ oneMonthPriceChange	number	-0.007
🏁 competitive	number	0.9036
🏷️ tags	array<string>	["Soccer", "Sports", "FIFA World Cup"]
📝 description	string	"This market resolves..."
🎬 startDate	string	"2025-07-02T22:28:24Z"
🛑 endDate	string	"2026-07-20T00:00:00Z"
🛎️ createdAt	string	"2025-07-02T16:54:39Z"
🔁 updatedAt	string	"2026-05-16T07:21:08Z"
📜 resolutionSource	string	"Official FIFA announcement"
💬 commentCount	number	730
🔢 marketsCount	number	60
📦 markets	array	[{ id, question, outcomePrices, ... }]
📚 orderbook	object	{ bids: [...], asks: [...] }
🕓 scrapedAt	string	"2026-05-16T07:31:18Z"
🐛 error	string	(only present on failure)

📦 Sample records

---

✨ Why choose this Actor

	Capability
🏷️	3,600+ category slugs. Every Polymarket tag is enumerated in the input schema, no guessing required.
🔄	Two output shapes. Group child markets under one event, or pivot to one row per binary question.
📚	Optional orderbook depth. Pull full CLOB bid and ask ladders for every market outcome on demand.
🔍	Free-text search. Surface events by keyword, ticker, or person without browsing the full catalog.
📊	Full trading metrics. 24-hour, weekly, monthly, and yearly volume, liquidity, open interest, multiple price-change windows, competitiveness.
🚦	Status filters. Pull active markets, resolved closed markets, or archived markets for historical study.
⚡	No API key, no wallet. Pure HTTP against the public Gamma API. Runs in seconds, scales to the full catalog.

📊 5 records returned in under one second on a clean cold start.

---

📈 How it compares to alternatives

Approach	Cost	Coverage	Refresh	Filters	Setup
⭐ Polymarket Prediction Market Scraper (this Actor)	Pay-per-use	Full live catalog	Real-time	Category, status, volume, date, search	Click run
Direct Gamma API	Free (until rate-limited)	Full	Real-time	Yes	Read docs, build pagination, parse fields
Paid market-data APIs	Subscription	Cross-venue	Real-time	Yes	Sign up, manage keys
DIY browser scraper	Engineering time	Page-limited	On-demand	Manual	Build, host, maintain
Legacy CSV dumps	Free	Stale snapshot	Days late	No	Hunt, clean, reformat

If you need fresh prediction-market data without managing pagination, retries, or schema drift, this Actor handles the whole pipeline.

---

🚀 How to use

1. ✍️ Sign up. Create a free Apify account.
2. 🔎 Open the Actor. Land on the run page and review the input form.
3. 🎛️ Configure filters. Pick a category, status, sort order, and any volume or date bounds. Leave blank for the full active catalog.
4. ▶️ Run. Click Start and watch the live log push records as they arrive.
5. 📥 Export. Download as JSON, CSV, Excel, or HTML, or hit the dataset API from your own code.

⏱️ Total time: under 30 seconds for the default 10-item preview, under 5 minutes for 10,000 events.

---

💼 Business use cases

📈 Trading desks Cross-reference Polymarket odds with order book depth on derivatives Build event-driven trading signals from 24h volume spikes Hedge directional exposure against political or macro events Backtest sentiment-based strategies against resolved markets	📰 Journalists and analysts Cite live prediction-market odds in opinion and analysis pieces Track shifts in election or geopolitical sentiment across the week Compare prediction-market consensus with polling and survey data Surface the most-traded events for newsletter or social posts
🧠 AI and ML teams Train forecasting models on historical odds versus actual outcomes Build sentiment features for downstream models in finance and politics Curate datasets of resolved binary questions for calibration research Stream live odds into retrieval-augmented generation pipelines	🏛️ Researchers and academics Study prediction-market accuracy across categories and time horizons Quantify the wisdom-of-crowds effect on geopolitical events Track how new information moves odds in real time Compare DeFi prediction markets with traditional polling

---

🌟 Beyond business use cases

Data like this powers more than commercial workflows. The same structured records support research, education, civic projects, and personal initiatives.

🎓 Research and academia Empirical datasets for papers, thesis work, and coursework Longitudinal studies tracking changes across snapshots Reproducible research with cited, versioned data pulls Classroom exercises on data analysis and ethical scraping	🎨 Personal and creative Side projects, portfolio demos, and indie app launches Data visualizations, dashboards, and infographics Content research for bloggers, YouTubers, and podcasters Hobbyist collections and personal trackers
🤝 Non-profit and civic Transparency reporting and accountability projects Advocacy campaigns backed by public-interest data Community-run databases for local issues Investigative journalism on public records	🧪 Experimentation Prototype AI and machine-learning pipelines with real data Validate product-market hypotheses before engineering spend Train small domain-specific models on niche corpora Test dashboard concepts with live input

---

🔌 Automating Polymarket Prediction Market Scraper

Trigger this Actor from your own stack and pull the dataset wherever you need it.

• Node.js client - call the Actor and stream results with the official Apify SDK.
• Python client - run jobs and read datasets directly from a Python script.
• API reference - hit the REST endpoints from any language or no-code tool.

Set up Apify schedules to run the scraper every hour, every morning before market open, or right before a known resolution event. The output dataset stays addressable by ID for downstream pipelines.

---

❓ Frequently Asked Questions

---

🔌 Integrate with any app

• Zapier - push records to spreadsheets, Slack, or your CRM on every run.
• Make - chain the scraper into multi-step automations with branching logic.
• n8n - self-host an open workflow that triggers the Actor on a cron.
• Airbyte - sync the dataset into Snowflake, BigQuery, or Postgres on a schedule.
• Google Sheets - import results directly via the Apify integration.
• Slack - get notified when a scheduled run finishes or surfaces a volume spike.

---

🔗 Recommended Actors

• 📊 Yahoo Finance Stock & Crypto Scraper - pull live stock and crypto quotes to cross-reference with Polymarket odds.
• 🪙 CoinGecko Cryptocurrency Scraper - grab spot prices and market caps for crypto questions on Polymarket.
• 🦙 DefiLlama DeFi Protocol Scraper - track DeFi TVL alongside on-chain prediction market data.
• 📰 Google News Scraper - pair odds movement with headline volume on the same topics.
• 🐦 X.com Post Scraper - mine social sentiment around active Polymarket events.

💡 Pro Tip: browse the complete ParseForge collection for more data scrapers across finance, news, real estate, and public records.

---

🆘 Need Help? Open our contact form and a real human will reply within one business day.

---

⚠️ Disclaimer: This Actor accesses publicly available data from Polymarket's public Gamma and CLOB APIs. You are responsible for compliance with Polymarket's terms of service, applicable laws in your jurisdiction, and any onward use of the data. Nothing in the output is financial advice. Verify resolutions and live odds at the source before trading.