Polymarket Scraper — Odds, Volume, Events & Price History

What does the crowd think will happen, how sure is it, and how much money says so?

Every open market on Polymarket as a table you can sort: the question, the current odds as a percentage, how the odds moved in the last day and week, 24-hour and all-time volume, liquidity, when it resolves and a link. Or one row per event — the question page that groups related markets — with the option the crowd currently favours. Or the daily closing price of every outcome, for charts and backtests.

Filter by keyword, by Polymarket tag, by a volume floor, or hand it specific links. No login. No API key. No wallet. No proxies.

---

Three modes

Markets — one row per market. The default. "Will X happen?" with its Yes price as a percentage, volume, liquidity and resolution date. Multi-option events (nominees, price ranges, dates) appear as one row per option with the parent event named.

Events — one row per event. The page you see on polymarket.com: title, category, how many markets it holds, which option leads and by how much, total and 24-hour volume, liquidity, open interest, comments.

History — one row per day per outcome. Daily closing prices for each outcome token of the markets in scope, for the last week, the last month or the market's whole life.

---

What you get

Markets

The question — question, eventTitle, option (for multi-option events), outcomes, tags, resolutionSource, description (optional)

The odds — prices (per outcome, 0–1), probabilityPercent (first outcome, usually Yes), lastTradePrice, bestBid, bestAsk, spread, priceChange24h and priceChange1w (percentage points)

The money — volumeTotal, volume24h, volume1w, volume1m, liquidity (all USD)

Timing and state — status (open, paused, closed, resolved), resolvedOutcome, startDate, endDate, daysToResolution, acceptingOrders, negRisk

Identifiers — marketUrl, eventSlug, marketSlug, marketId, conditionId, clobTokenIds, imageUrl, createdAt, updatedAt

Events

title, category, tags, marketsCount, openMarketsCount, leadingOption, leadingProbabilityPercent, volumeTotal, volume24h, volume1w, liquidity, openInterest, commentCount, status, startDate, endDate, daysToResolution, negRisk, eventUrl, eventSlug, eventId, imageUrl, createdAt, updatedAt, description (optional)

History

question, option, outcome, date, timestamp, price, probabilityPercent, marketUrl, marketSlug, eventSlug, clobTokenId

---

Typical uses

• A daily odds sheet. Markets mode, sorted by 24h volume, on a schedule — what the market is arguing about today and where the odds moved.
• Track one question over time. History mode on the event link, whole life — a chart-ready series per outcome.
• Research a topic. Keyword fed rate or tag crypto, all statuses — every market ever listed on it, with resolved outcomes for the closed ones.
• Feed a model or an agent. Clean numbers, no strings to parse: prices are numbers, volumes are USD, dates are ISO.

---

Input

Field	What it does
mode	markets (default), events or history.
status	open (default), closed or all.
sortBy	volume24h (default), volume, liquidity, endingSoon, newest.
searchQuery	Keyword, through Polymarket's own search. At most 100 events per query.
tag	A tag slug from the site's URLs: politics, crypto, sports, business, science, culture, tech, world.
urls	Event or market links to read exactly. Overrides keyword, tag and sort.
minVolume	Skip markets below this all-time volume in USD.
maxItems	Cap on rows returned, and on what you are billed. Default 100, up to 5,000.
includeDescription	Adds the full resolution rules as a column.
historyRange	1w, 1m (default) or max. History mode only.

---

What it costs

$2.00 per 1,000 markets, $5.00 per 1,000 events, $1.00 per 1,000 price-history rows, plus $0.005 per run. Apify's Starter, Scale and Business plans get 10%, 20% and 30% off.

You pay for rows delivered. A keyword that matches nothing, a link that does not exist, or a filter that removes everything costs nothing.

---

How it works

Polymarket's website is a front end on two public JSON APIs — one for markets, events, tags and search, one for price history per outcome token. Both answer without an account, a key or a wallet. This actor reads them, turns Polymarket's string-encoded arrays and decimal strings into real numbers, attaches each market to its parent event so tags and links are right, and hands back a flat table. No HTML is parsed and no browser is launched, so a redesign of the site does not break it.

---

Honest limits

• Prices are a snapshot at run time. Odds move by the minute; the updatedAt column says when Polymarket last touched the row. Schedule the run if you want the curve.
• probabilityPercent is the first outcome's price. For a Yes/No market that is Yes. For a market with other outcome names (Lions / Bills) look at outcomes and prices side by side.
• Keyword search returns at most 100 events, the same limit the site has. status says so when it hits. Use a tag or a volume floor for broad topics.
• Tags belong to events. In plain markets mode (no keyword, no tag, no link) the tags column can be empty because Polymarket's market list does not carry them; use events mode or a tag filter when you need categories.
• History is daily closes from Polymarket's order book, one point per day per outcome. Markets without trades on a day have no point for that day. Very new markets may return no history yet; status counts those.
• History grows fast, so maxItems is a hard stop. An event link covers every option in that event, and each option costs one row per day per outcome — a 50-option election over a month is thousands of rows. The run stops at maxItems, keeps each outcome's series whole, and status says how many markets it got through. Link a single market, or raise the cap deliberately.
• Closed markets show resolvedOutcome only when Polymarket has settled the payout (one outcome priced at 1). A market that has ended but not yet settled shows closed with no outcome.
• Polymarket restricts access from some countries (HTTP 451). Apify's servers are not affected; a local run from a restricted region will be.

---

Scheduling

Odds change daily. Schedule markets mode on your filters and each run adds a dated snapshot; schedule history mode weekly on the events you follow and you keep the full series without gaps.

---

Legal

This actor reads only Polymarket's public APIs, the same ones its website calls for any visitor, without authentication. It requires no account and bypasses no access control. Market data is public information about a public marketplace; the actor returns no user or wallet data. You remain responsible for how you use the exported data, including any local rules on prediction markets.

---

Questions, or a market that behaves oddly? Open an issue on the actor — issues are read and answered.