Skip to main content
POST
/
books
Get multiple order books summaries by request
curl --request POST \
  --url https://clob.polymarket.com/books \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "token_id": "1234567890"
  },
  {
    "token_id": "0987654321"
  }
]
'
[
  {
    "market": "0x1b6f76e5b8587ee896c35847e12d11e75290a8c3934c5952e8a9d6e4c6f03cfa",
    "asset_id": "1234567890",
    "timestamp": "2023-10-01T12:00:00Z",
    "hash": "0xabc123def456...",
    "bids": [
      {
        "price": "1800.50",
        "size": "10.5"
      }
    ],
    "asks": [
      {
        "price": "1800.50",
        "size": "10.5"
      }
    ],
    "min_order_size": "0.001",
    "tick_size": "0.01",
    "neg_risk": false
  }
]

Body

application/json
Maximum array length: 500
​
token_id
string
required

The unique identifier for the token

Example:

"1234567890"

​
side
enum<string>

Optional side parameter for certain operations

Available options:
BUY,
SELL
Example:

"BUY"

Response

Successful response

​
market
string
required

Market identifier

Example:

"0x1b6f76e5b8587ee896c35847e12d11e75290a8c3934c5952e8a9d6e4c6f03cfa"

​
asset_id
string
required

Asset identifier

Example:

"1234567890"

​
timestamp
string<date-time>
required

Timestamp of the order book snapshot

Example:

"2023-10-01T12:00:00Z"

​
hash
string
required

Hash of the order book state

Example:

"0xabc123def456..."

​
bids
object[]
required

Array of bid levels

​
asks
object[]
required

Array of ask levels

​
min_order_size
string
required

Minimum order size for this market

Example:

"0.001"

​
tick_size
string
required

Minimum price increment

Example:

"0.01"

​
neg_risk
boolean
required

Whether negative risk is enabled

Example:

false