Skip to main content
GET
/
polymarket
/
order-book
/
market
Get order books for a market
curl --request GET \
  --url https://api.struct.to/v1/polymarket/order-book/market
[
  {
    "ts": 123,
    "position_id": "<string>",
    "condition_id": "<string>",
    "bids": [
      {
        "p": "<string>",
        "s": "<string>"
      }
    ],
    "asks": [
      {
        "p": "<string>",
        "s": "<string>"
      }
    ],
    "hash": "<string>",
    "best_bid": 123,
    "best_ask": 123,
    "mid_price": 123,
    "spread": 123,
    "bid_liquidity_usd": 123,
    "ask_liquidity_usd": 123,
    "bid_levels": 123,
    "ask_levels": 123
  }
]

Query Parameters

condition_id
string

Condition ID of the market

market_slug
string

Market slug (alternative to condition_id)

Response

Latest orderbook snapshot per position. ts is Unix milliseconds.

ts
integer<int64>
required
position_id
string
required
condition_id
string
required
bids
object[]
required
asks
object[]
required
hash
string
required
best_bid
number<double> | null
best_ask
number<double> | null
mid_price
number<double> | null
spread
number<double> | null
bid_liquidity_usd
number<double> | null
ask_liquidity_usd
number<double> | null
bid_levels
integer<int32> | null
ask_levels
integer<int32> | null
Last modified on March 17, 2026