Polymarket Markets Scraper
Pricing
from $0.02 / 1,000 markets
Scrape Polymarket prediction markets: odds, prices, volume, liquidity, order book, price history and trades. Search by keyword, category or market URL. Export to JSON, CSV or Excel.
Market ID
id
Required
Numeric Polymarket market id.
Market URL
url
Required
Public market page.
Slug
slug
Required
Question
question
Required
Description
description
Optional
Full resolution rules as written on the market.
Condition ID
conditionId
Optional
On-chain condition id, the key used by the CLOB and the trade API.
Question ID
questionId
Optional
CLOB token IDs
clobTokenIds
Required
One ERC-1155 token id per outcome, in the same order as outcomes. Parsed into a real array (the API sends a JSON string).
[ "27146956652877944551877724690365745048289675287536243265951843487691050802191"]Outcomes
outcomes
Required
Outcome labels, parsed into a real array (the API sends a JSON string).
[ "Yes", "No"]Outcome prices
outcomePrices
Required
Price of each outcome between 0 and 1 — the market's implied probability. Numbers, in the same order as outcomes.
[ 0.63, 0.37]Yes price
yesPrice
Optional
Shortcut for the price of the Yes outcome; null when the outcomes are not Yes / No (team names, Over / Under, Up / Down: 12 % of the markets).
No price
noPrice
Optional
Shortcut for the price of the No outcome; null when the outcomes are not Yes / No (see yesPrice).
Best bid
bestBid
Optional
Best ask
bestAsk
Optional
Spread
spread
Optional
Best ask minus best bid, in probability points.
Last trade price
lastTradePrice
Optional
Total volume (USD)
volume
Optional
24h volume (USD)
volume24hr
Optional
7d volume (USD)
volume1wk
Optional
30d volume (USD)
volume1mo
Optional
1y volume (USD)
volume1yr
Optional
Liquidity (USD)
liquidity
Optional
Open interest (USD)
openInterest
Optional
1h price change
priceChange1h
Optional
Change in probability points over the last hour; the API does not send it on every market, then it is null.
24h price change
priceChange24h
Optional
7d price change
priceChange1wk
Optional
30d price change
priceChange1mo
Optional
Start date
startDate
Optional
When the market opened, ISO 8601 UTC. Read by the postedAfter / postedBefore filters.
End date
endDate
Optional
When the market is due to close, ISO 8601 UTC. Read by the endingAfter / endingBefore / endingWithinMinutes filters.
Created at
createdAt
Optional
ISO 8601 UTC.
Closed at
closedTime
Optional
When the market actually closed, normalised to ISO 8601 UTC (the API sends 2026-09-20 04:26:51+00). Null while the market is open.
Active
active
Required
Closed
closed
Required
Archived
archived
Required
Accepting orders
acceptingOrders
Optional
Accepting orders since
acceptingOrdersTimestamp
Optional
When the order book opened (ISO 8601 UTC).
Resolved
resolved
Required
True when the market is settled and the winning outcome is known.
Winning outcome
winningOutcome
Optional
Label of the outcome that paid out — the outcome whose final price is 1. Null while the market is not resolved, and on the rare market settled 50/50 (a cancelled match: both outcomes at 0.5, no single winner).
Resolution source
resolutionSource
Optional
UMA resolution status
umaResolutionStatus
Optional
Automatically resolved
automaticallyResolved
Optional
Resolver contract
resolvedBy
Optional
On-chain address of the contract that settles the market (the UMA adapter).
UMA bond
umaBond
Optional
Bond posted by the resolver, in USDC.
UMA reward
umaReward
Optional
Maker fee
makerBaseFee
Optional
Taker fee
takerBaseFee
Optional
Fee category
feeType
Optional
Polymarket's fee category of the market (politics_fees, sports_fees_v3, crypto_fees_v2, zero_fees…). Null on a market without one.
Fee schedule
feeSchedule
Optional
The schedule of that category: rate (taker fee rate), exponent, takerOnly, rebateRate (maker rebate share).
Rewards min size
rewardsMinSize
Optional
Minimum order size that earns liquidity rewards.
Rewards max spread
rewardsMaxSpread
Optional
Maximum spread, in cents, still eligible for liquidity rewards.
Min order size
orderMinSize
Optional
Price tick size
orderPriceMinTickSize
Optional
Competitiveness
competitive
Optional
Polymarket's own 0-1 score of how tightly the market is quoted.
Group item title
groupItemTitle
Optional
Short label of this market inside a grouped event (e.g. the candidate's name). Null outside a group.
Handicap line
line
Optional
Handicap or threshold of a sports market; null elsewhere.
Featured
featured
Optional
Restricted
restricted
Optional
Market not tradable from every country.
Funded
funded
Optional
Order book enabled
enableOrderBook
Optional
Updated at
updatedAt
Optional
Last change on the site, ISO 8601 UTC.
Negative risk
negRisk
Optional
Market belongs to a group where exactly one outcome can win.
Negative-risk group id
negRiskMarketId
Optional
Id of the negative-risk group the market belongs to (the markets of one multi-outcome event share it). Null outside such a group.
Negative-risk request id
negRiskRequestId
Optional
Id of the market's question inside its negative-risk group. Null outside such a group.
Image
imageUrl
Optional
Icon
iconUrl
Optional
Parent event (option)
event
Optional
Event the market belongs to: id, slug, title, description, url, volume, liquidity, openInterest, commentCount, startDate, endDate, negRisk, negRiskAugmented (the group takes outcomes added later). Null when 'Include parent event' is off.
Order book (option)
orderBook
Optional
Live CLOB book per outcome: { "<outcome>": { "bids": [{ "price": 0.62, "size": 1200 }], "asks": [...] } }, cut to 'Order book depth' levels. Null when the option is off.
Price history (option)
priceHistory
Optional
Price time series per outcome: { "<outcome>": [{ "t": "2026-09-20T04:00:00.000Z", "p": 0.63 }] }. Null when the option is off.
Recent trades (option)
recentTrades
Optional
Latest trades, newest first (up to 1,000 per market): side, size, price, sizeUsd, outcome, timestamp (ISO), wallet, pseudonym, name (user name), profileImageUrl, transactionHash. Null when the option is off.
Top holders (option)
topHolders
Optional
Biggest position holders per outcome (20 by default, up to 500): wallet, pseudonym, name (null when the holder keeps it private), verified, displayUsernamePublic, profileImageUrl, outcome, size. Null when the option is off.
Search URL
searchUrl
Optional
API query the market was found by; null for markets fetched by slug or id.
Scraped at
scrapedAt
Required
ISO 8601 timestamp of the extraction.
Event comments (option)
comments
Optional
Comments of the market's event, newest threads first, replies right after their thread: id, body (plain text), createdAt, updatedAt, parentCommentId (the thread of a reply), parentEntityType, parentEntityId, userAddress, name (null when the author keeps it private), pseudonym, wallet, profileImageUrl, reactionCount, reportCount, reactions (type, userAddress, wallet), media (type, url, altText). Null when the option is off.