Get Order Book

Get Order Book.

GET /api/v4/prediction/tokens/{token_id}/order_book

Get Order Book

cURL

curl --request GET \
  --url https://api.dexbuilder.com/api/v4/prediction/tokens/{token_id}/order_book

200

{
  "condition_id": "<string>",
  "token_id": "<string>",
  "timestamp": 123,
  "hash": "<string>",
  "bids": [
    {
      "price": "<string>",
      "size": "<string>"
    }
  ],
  "asks": [
    {
      "price": "<string>",
      "size": "<string>"
    }
  ],
  "min_order_size": "<string>",
  "tick_size": "<string>",
  "neg_risk": true,
  "last_trade_price": "<string>"
}

Returns the current order book for a token.

Base URL: https://api.dexbuilder.com

Authentication: This is a public market-data endpoint and does not require authentication.

​

Request

curl -G "https://api.dexbuilder.com/api/v4/prediction/tokens/{token_id}/order_book"

token_id identifies the token. Use depth to request a supported number of levels.

The OpenAPI panel below is the source of truth for required parameters, types, enum values, and request-body fields. Timestamps are Unix timestamps unless the field description states otherwise.

​

Response

Returns the token ID and ordered bid/ask levels. Each level contains price and size.

A successful response uses HTTP 200. Invalid parameters or request bodies return HTTP 400. Private endpoints can return HTTP 401 when authentication fails, and temporary upstream failures can return HTTP 503. The error response contains a machine-readable label and message.

For order, position, claim, transfer, and account operations, treat the response as the current server result and query the resource again when the operation is asynchronous.

Path Parameters

token_id · string · required

Query Parameters

depth · integer · default: 20

Required range: 1 <= x <= 100

Response

200

application/json

Request succeeded

Market order book response.

condition_id · string

token_id · string

timestamp · integer | null

Source snapshot time in Unix milliseconds; null when unavailable.

hash · string | null

Hash of the full source snapshot; null when unavailable.

bids · object[]

Show child attributes

asks · object[]

Show child attributes

min_order_size · string | null

tick_size · string | null

neg_risk · boolean | null

last_trade_price · string | null