Order book

Top-of-book time series — best bid and best ask for each side of a market, sorted by timestamp. For full L25 depth, download the per-slug Parquet dataset.

Get book history

GET/v1/markets/{conditionId}/book

Query parameters

Field	Type	Description
side	string	Filter to one side: `yes` or `no`. Omit to receive both, interleaved.
from	ISO 8601	Start of the window. Optional.
to	ISO 8601	End of the window. Optional.
limit	integer	Page size, 1–1000. Defaults to 100.
offset	integer	Number of rows to skip. Defaults to 0.

Note

Order books are large. For windows over a day or so, prefer bulk Parquet downloads — same data, no pagination, free egress.

Response

200 OK

{
  "data": [
    {
      "ts": "2025-03-31T20:00:00Z",
      "side": "YES",
      "best_bid": 0.62,
      "best_ask": 0.63
    }
  ],
  "pagination": {
    "limit": 100,
    "offset": 0,
    "total": 8421
  }
}