Skip to content
Tools / Polymarket
Polymarket icon

Polymarket

Prediction market prices & history

Polymarket gives you read-only access to the world's largest prediction market. Browse thousands of active markets on elections, macroeconomic events, sports, crypto, and geopolitics. Fetch real-time prices, order books, spreads, and historical probability charts for any outcome token — all without needing a trading account.

Prediction markets express collective beliefs as probabilities priced between 0 and 1. A price of 0.65 on a "Yes" token means the market currently gives that outcome a 65% chance. This makes Polymarket data useful not just for traders, but for researchers, journalists, and analysts who want to understand how the crowd is pricing specific future events compared to polls, forecasts, or models.

What you can do

  • Browse active markets with condition IDs, token IDs, and current prices
  • Get real-time bid and ask prices, midpoint prices, and last traded prices
  • View full order book depth for any outcome token
  • Fetch historical price charts at multiple intervals (1m, 1h, 1d, 1w, 1mo, 1y)
  • Calculate estimated fill price for a specific order size
  • Check bid-ask spreads, tick sizes, and fee rates
  • Batch multiple token queries in a single request

Who it's for

Traders monitoring positions and market depth, researchers studying crowd-based probability forecasting, journalists tracking event odds, data analysts building prediction market datasets, and developers integrating Polymarket data into applications.

How to use it

  1. Use list_simplified_markets for a quick scan of active markets with prices
  2. Use get_market with a condition ID for full market details and token IDs
  3. Use get_order_book with a token ID to inspect liquidity and depth
  4. Use get_prices_history to chart how probability has changed over time
  5. Use calculate_market_price to estimate slippage for a specific order size

Getting started

No setup required — all skills use the public read-only market data endpoint.

Health Check

Verify that the public Polymarket CLOB API is reachable before you start making market data calls.

Returns: A simple health status string confirming whether the public CLOB service responded
Get Server Time

Fetch the current Polymarket CLOB server timestamp so you can align polling or compare event freshness.

Returns: The current CLOB server time as a Unix timestamp in seconds
List Markets

List full CLOB market objects page by page so you can browse condition IDs, questions, tokens, and market metadata.

Returns: A paginated page of full CLOB market objects plus the cursor for the next page
Get Market

Fetch one CLOB market by condition ID when you need the question, tokens, fees, timing, and reward config.

Returns: One full market object for the requested condition ID
List Simplified Markets

List the lighter simplified market feed when you want condition IDs, token IDs, prices, and reward flags quickly.

Returns: A paginated page of simplified market rows with token IDs and current prices
List Sampling Markets

List full markets that are eligible for sampling or liquidity rewards so you can inspect incentive-backed opportunities.

Returns: A paginated page of reward-eligible full market objects
List Sampling Simplified Markets

List the lighter reward-eligible markets feed when you need token IDs and current prices for sampling markets fast.

Returns: A paginated page of reward-eligible simplified market rows
Get Order Book

Fetch the full bid and ask ladder for one Polymarket token so you can inspect liquidity and visible depth.

Returns: A full order book snapshot with bids, asks, tick size, minimum size, and the book hash
Get Order Books

Fetch multiple Polymarket order books in one request so you can compare liquidity across tokens efficiently.

Returns: An array of order book snapshots for the requested token IDs
Get Market Price

Fetch the current best bid or ask for one token when you need the executable top-of-book price right now.

Returns: The best currently executable price for the requested token and side
Get Market Prices

Fetch best prices for multiple tokens in one call when you need a quick snapshot across a basket of outcomes.

Returns: A token-indexed map of best prices for the requested token IDs
Get Midpoint Price

Fetch the midpoint between the best bid and ask for a token so you can inspect the displayed implied probability.

Returns: The midpoint price for the requested token
Get Midpoint Prices

Fetch midpoint prices for multiple tokens in one call when you want a compact implied probability snapshot.

Returns: A token-indexed map of midpoint prices for the requested tokens
Get Spread

Fetch the current bid-ask spread for one token so you can judge liquidity and slippage risk quickly.

Returns: The current bid-ask spread for the requested token
Get Spreads

Fetch spreads for multiple tokens in one request when you want a quick liquidity comparison across outcomes.

Returns: A token-indexed map of current spreads for the requested tokens
Get Last Trade Price

Fetch the most recent traded price and side for one token when you need the last executed market print.

Returns: The latest traded price and side for the requested token
Get Last Trade Prices

Fetch the latest traded price for multiple tokens in one request so you can compare the last executed prints.

Returns: An array of latest-trade snapshots for the requested token IDs
Get Prices History

Fetch historical price points for one token so you can chart implied probability changes over time.

Returns: Historical price points for the requested token and interval
Get Tick Size

Fetch the minimum price increment for a token so you know what price precision the market currently accepts.

Returns: The current minimum tick size for the requested token
Get Fee Rate

Fetch the base fee rate for a token so you can understand the cost assumptions behind order placement.

Returns: The base fee rate in basis points for the requested token
Get Negative Risk Flag

Check whether a token belongs to a negative-risk market so you can reason about complementary outcome mechanics.

Returns: A boolean showing whether the requested token is part of a negative-risk market
Calculate Market Price

Estimate fill price for a given order size by walking the visible order book. Read-only — no order is placed.

Returns: An estimated fill price based on visible order book depth for the requested trade size
Raw Public Request

Call an allowlisted unauthenticated public CLOB endpoint directly when you need a path that is not covered by the typed skills.

Returns: The raw payload from an allowlisted unauthenticated public CLOB endpoint
Loading reviews...

Loading activity...

v0.022026-03-22
  • Added subtitle, expanded description, and agent instructions
v0.012026-03-21
  • Initial release with unauthenticated public CLOB market, price, orderbook, and raw request skills

Polymarket Use Cases(3)

Browse all 3 Polymarketguides →
Open Search Papers by Topic

Search Papers by Topic

Find relevant academic papers on any research topic across millions of scholarly publications.

Academic Research icon
Academic Research
4 agent guides
Open Geocode Addresses to Coordinates

Geocode Addresses to Coordinates

Convert street addresses into precise latitude and longitude coordinates for mapping and spatial analysis.

Address Geocoding icon
Address Geocoding
4 agent guides
See every Polymarketuse case (Claude, ChatGPT, Copilot, OpenClaw guides) →

Related Tools

Popular with

Frequently Asked Questions

Can I browse markets before looking at prices?

Yes. `list_markets` and `list_simplified_markets` let you browse active markets, condition IDs, token IDs, and metadata before drilling into a specific market.

How do I check current prices and liquidity?

Use `get_market_price`, `get_midpoint_price`, `get_last_trade_price`, `get_order_book`, and `get_spread` to compare executable price, mid, last trade, and visible depth.

Can I estimate the fill price for a larger order?

Yes. `calculate_market_price` walks the visible order book to estimate the fill for a given size. It is read-only, so no order is placed.

Is there a way to check special market flags?

Yes. `get_neg_risk` tells you whether a token belongs to a negative-risk market, and `raw_public_request` is available if you need an allowlisted endpoint that is not covered elsewhere.