Skip to main content
POST
/
books
Get multiple order books summaries by request
curl --request POST \
  --url https://clob.forka.st/books \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "token_id": "66991175107696133528353695394151645462081911990365106169948013117379189357520",
    "side": "BUY"
  },
  {
    "token_id": "106199154714545451005463800266480893448383896699905306895283360115694583822185",
    "side": "SELL"
  }
]
'
[
  {
    "market": "0x386a6833f7f758e22588159c614939047ff2d8e24810e8cf5e946ebc2bdaf82c",
    "asset_id": "66991175107696133528353695394151645462081911990365106169948013117379189357520",
    "timestamp": "1762177835497",
    "hash": "c3bbc748d4ca1009aa2968e40c64570d2d9bce718d52348c3017c290fb69faf6",
    "bids": [],
    "asks": [
      {
        "price": "0.45",
        "size": "5"
      },
      {
        "price": "0.5",
        "size": "5"
      },
      {
        "price": "0.55",
        "size": "5"
      },
      {
        "price": "0.6",
        "size": "5"
      },
      {
        "price": "0.65",
        "size": "5"
      }
    ],
    "min_order_size": "0.001",
    "tick_size": "0.0001",
    "neg_risk": false
  },
  {
    "market": "0x386a6833f7f758e22588159c614939047ff2d8e24810e8cf5e946ebc2bdaf82c",
    "asset_id": "106199154714545451005463800266480893448383896699905306895283360115694583822185",
    "timestamp": "1762177835497",
    "hash": "aad9015f4c0aa3ddb2c1ad865a06966e64934e8405bc73c8a8a189343d49fa00",
    "bids": [],
    "asks": [
      {
        "price": "0.9894",
        "size": "1821.760525"
      },
      {
        "price": "0.99",
        "size": "2547"
      }
    ],
    "min_order_size": "0.001",
    "tick_size": "0.0001",
    "neg_risk": false
  }
]
Submit a batch of token_ids to retrieve their latest order book snapshots in a single call. The timestamp is a Unix millisecond timestamp indicating when the snapshot was taken. Only the first few bid and ask levels are shown in this excerpt; the live response can include many more.

Body

application/json
Minimum array length: 1
​
token_id
string
required

The unique identifier for the token.

Example:

"66991175107696133528353695394151645462081911990365106169948013117379189357520"

​
side
enum<string>

Optional side parameter.

Available options:
BUY,
SELL
Example:

"BUY"

Response

200 - application/json

Successful response

​
market
string
required

Market identifier.

Example:

"0x386a6833f7f758e22588159c614939047ff2d8e24810e8cf5e946ebc2bdaf82c"

​
asset_id
string
required

Asset identifier.

Example:

"66991175107696133528353695394151645462081911990365106169948013117379189357520"

​
timestamp
string
required

Unix timestamp in milliseconds for the order book snapshot.

Example:

"1761751548968"

​
hash
string
required

Hash of the order book state.

Example:

"4bda9943ce2aa22cac036e8c8d2d90ad084ccdf390cc142a0c185c507080fba8"

​
bids
object[]
required

Array of bid levels.

Example:
[
  { "price": "0.0276", "size": "114.704237" },
  { "price": "0.025", "size": "457" },
  { "price": "0.0234", "size": "431" },
  { "price": "0.018", "size": "432" }
]
​
asks
object[]
required

Array of ask levels.

Example:
[
  { "price": "0.0281", "size": "205.384112" },
  { "price": "0.0294", "size": "389.25044" },
  { "price": "0.0309", "size": "276.510008" },
  { "price": "0.0325", "size": "198.75" }
]
​
min_order_size
string
required

Minimum order size for this market.

Example:

"0.001"

​
tick_size
string
required

Minimum price increment.

Example:

"0.0001"

​
neg_risk
boolean
required

Whether negative risk is enabled.

Example:

false