---
title: "Get Limitless Orderbooks"
method: GET
path: "/v2/limitless/orderbooks"
tags: ["limitless"]
---

# Get Limitless Orderbooks

`GET /v2/limitless/orderbooks`

Fetch historical orderbook snapshots for a Limitless market over a specified time range.

Returns YES-side orderbook snapshots. To derive the NO orderbook,
invert client-side: flip bids/asks and transform prices to 1 - price.
All timestamps are in milliseconds.

## Query parameters

- `market_slug` string, required — The Limitless market slug
- `start_time` integer, required — Start time in Unix timestamp (milliseconds)
- `end_time` integer, required — End time in Unix timestamp (milliseconds)
- `limit` integer — Maximum number of snapshots to return
- `pagination_key` string, nullable — Pagination key to get the next chunk of data

## Response `200`

Successful Response

- LimitlessOrderbooksResponse — Limitless orderbooks endpoint response.
  - `snapshots` LimitlessOrderbookSnapshot[], required
    - `market_slug` string, required — Market slug identifier
    - `token_id` string, required — YES token ID (metadata)
    - `timestamp` integer, required — Snapshot timestamp (Unix epoch MILLISECONDS)
    - `bids` LimitlessOrderbookLevel[], required — Bid levels (buying YES)
      - `price` number, required — Price level (0-1 range)
      - `size` number, required — Size at this price level
    - `asks` LimitlessOrderbookLevel[], required — Ask levels (selling YES)
      - `price` number, required — Price level (0-1 range)
      - `size` number, required — Size at this price level
    - `midpoint` number, required — Midpoint price
    - `adjusted_midpoint` number, required — Adjusted midpoint price
  - `pagination` CursorPagination, required — Cursor-based pagination for endpoints that don't support offset.
    - `limit` integer, required — Requested limit
    - `count` integer, required — Number of items in current response
    - `pagination_key` string, nullable — Base64-encoded cursor for next page
    - `has_more` boolean, required — Whether there are more items available

## Other responses

- `400` — Bad Request
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/predexon/apis/predexon-api.md) · [All operations](https://skmtc.net/predexon/apis/predexon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/predexon/predexon-api/revisions/80a306fbdb39/schema)