Orderbook

Get real-time orderbook depth for any market

Get Orderbook

GET

Retrieve the current orderbook with bid/ask depth for a market.

GET /api/v1/markets/{id}/orderbook

Path Parameters

ParameterTypeDescription
idstringMarket UUID

Query Parameters

ParameterTypeDefaultDescription
depthnumber10Number of price levels (max 50)

Example

curl -H "Authorization: Bearer or_live_xxx" \
  "https://api.tessradar.com/api/v1/markets/{id}/orderbook?depth=5"

Response

{
  "data": {
    "marketId": "e4ec57b5-94d1-4159-87c0-5bb6827928f7",
    "question": "Will Bitcoin reach $100k by end of 2026?",
    "exchange": "POLYMARKET",
    "timestamp": "2026-01-11T12:00:00.000Z",
    "outcome": "Yes",
    "bids": [
      { "price": 0.65, "size": 15000 },
      { "price": 0.64, "size": 22000 },
      { "price": 0.63, "size": 18500 },
      { "price": 0.62, "size": 31000 },
      { "price": 0.61, "size": 45000 }
    ],
    "asks": [
      { "price": 0.67, "size": 12000 },
      { "price": 0.68, "size": 19000 },
      { "price": 0.69, "size": 25000 },
      { "price": 0.70, "size": 28000 },
      { "price": 0.71, "size": 35000 }
    ],
    "spread": 0.02,
    "midPrice": 0.66
  }
}

Response Fields

FieldTypeDescription
bidsarrayBuy orders (highest first)
asksarraySell orders (lowest first)
spreadnumberDifference between best ask and bid
midPricenumberMiddle price between best bid/ask

Order Level Fields

FieldTypeDescription
pricenumberPrice level (0-1)
sizenumberTotal size at this price (USD)

Cost: 1 credit per request

Orderbook data is fetched in real-time from Polymarket CLOB and Kalshi APIs.

On this page