Skip to main content
GET
/
book
Get order book summary
curl --request GET \
  --url https://clob.forka.st/book
{
  "market": "0x386a6833f7f758e22588159c614939047ff2d8e24810e8cf5e946ebc2bdaf82c",
  "asset_id": "66991175107696133528353695394151645462081911990365106169948013117379189357520",
  "timestamp": "1761751548968",
  "hash": "4bda9943ce2aa22cac036e8c8d2d90ad084ccdf390cc142a0c185c507080fba8",
  "bids": [
    {
      "price": "0.0276",
      "size": "114.704237"
    },
    {
      "price": "0.025",
      "size": "457"
    },
    {
      "price": "0.0234",
      "size": "431"
    },
    {
      "price": "0.018",
      "size": "432"
    }
  ],
  "asks": [
    {
      "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": "0.001",
  "tick_size": "0.0001",
  "neg_risk": false
}
Fetch the latest order book snapshot for a single token_id. The timestamp value is a Unix millisecond timestamp; convert it to human-readable time as needed on the client. Only the first few depth levels are shown above; the full payload can contain additional bids and asks.

Query Parameters

​
token_id
string
required

The unique identifier for the token.

Response

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