Polymarket Scraper: Markets, Order Books & Top Holders
Pricing
$2.20 / 1,000 items
Polymarket markets ranked by 24h volume or liquidity, or any market in depth: order book per outcome, 24h price range, recent trades, top holders and open interest. $1.75 per 1,000 results, one flat rate, error rows free.
Row type
type
Optional
'market' (market list), 'insight' (one market in depth) or 'error' (why a market could not be read; not charged).
Market id
id
Optional
Polymarket's numeric market id, as a string.
Slug
slug
Optional
The market's slug.
URL
url
Optional
The market's page on polymarket.com.
Question
question
Optional
What the market asks.
Event slug
eventSlug
Optional
The event the market belongs to.
Event
eventTitle
Optional
The event's title.
Outcomes
outcomes
Optional
Outcome names, in Polymarket's order (e.g. Yes, No).
Outcome prices
outcomePrices
Optional
Last price per outcome, 0 to 1, in the order of outcomes.
Token ids
clobTokenIds
Optional
The order-book token id per outcome.
Condition id
conditionId
Optional
The market's on-chain condition id.
Total volume
volume
Optional
All-time traded volume, USDC.
24h volume
volume24h
Optional
Traded volume over the last 24 hours, USDC.
Liquidity
liquidity
Optional
Current liquidity, USDC.
Best bid
bestBid
Optional
Best bid on the first outcome.
Best ask
bestAsk
Optional
Best ask on the first outcome.
Spread
spread
Optional
Best ask minus best bid.
Last trade
lastTradePrice
Optional
Price of the last trade.
1h change
oneHourPriceChange
Optional
Price change over the last hour.
24h change
oneDayPriceChange
Optional
Price change over the last 24 hours.
Start
startDate
Optional
When the market opened.
End
endDate
Optional
When the market is scheduled to resolve.
Active
active
Optional
Whether the market is active.
Closed
closed
Optional
Whether the market is closed.
Input
input
Optional
Insight and error rows: what you asked for, as you typed it.
Open interest
openInterest
Optional
Insight only. Value of all open positions, USDC.
Per-outcome detail
outcomeStats
Optional
Insight only. Per outcome: price, tokenId, book (bestBid, bestAsk, spread, mid, bidDepth, askDepth, bids, asks) and price24h (points, open, close, change, low, high).
Recent trades
recentTrades
Optional
Insight only. Newest first: time, side, outcome, price, size, wallet, name.
Top holders
topHolders
Optional
Insight only. Per outcome, largest first: outcome, wallet, name, amount.
Section errors
sectionErrors
Optional
Insight only. Sections that could not be read this time; the rest of the row is still valid.
Error
error
Optional
Error rows only. A short code, e.g. market_not_found.
Error description
errorDescription
Optional
Error rows only. What went wrong, in words.
Collected at
collectedAt
Optional
When the server read this market.
