Skip to main content
POST
/
books
Get order books (request body)
curl --request POST \
  --url https://clob.polymarket.com/books \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "token_id": "0xabc123def456..."
  },
  {
    "token_id": "0xdef456abc123..."
  }
]
'
[
  {
    "market": "0x1234567890123456789012345678901234567890",
    "asset_id": "0xabc123def456...",
    "timestamp": "1234567890",
    "hash": "a1b2c3d4e5f6...",
    "bids": [
      {
        "price": "0.45",
        "size": "100"
      }
    ],
    "asks": [
      {
        "price": "0.46",
        "size": "150"
      }
    ],
    "min_order_size": "1",
    "tick_size": "0.01",
    "neg_risk": false,
    "last_trade_price": "0.45"
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.polymarket.com/llms.txt

Use this file to discover all available pages before exploring further.

Body

application/json
​
token_id
string
required

Token ID (asset ID)

Example:

"0xabc123def456..."

​
side
enum<string>

Order side (optional, not used for midpoint calculation)

Available options:
BUY,
SELL
Example:

"BUY"

Response

Successfully retrieved order books

​
market
string
required

Market condition ID

Example:

"0x1234567890123456789012345678901234567890"

​
asset_id
string
required

Token ID (asset ID)

Example:

"0xabc123def456..."

​
timestamp
string
required

Timestamp of the order book snapshot

Example:

"1234567890"

​
hash
string
required

Hash of the order book summary

Example:

"a1b2c3d4e5f6..."

​
bids
object[]
required

List of bid orders (sorted by price descending)

​
asks
object[]
required

List of ask orders (sorted by price ascending)

​
min_order_size
string
required

Minimum order size

Example:

"1"

​
tick_size
string
required

Minimum price increment (tick size)

Example:

"0.01"

​
neg_risk
boolean
required

Whether negative risk is enabled for this market

Example:

false

​
last_trade_price
string
required

Last trade price

Example:

"0.45"