Get Order Book Range

Fetch multiple orderbook snapshots within a time range.

GET /v1/orderbook/range

Get Order Book Range

cURL

curl --request GET \
  --url https://api.polydata.live/v1/orderbook/range \
  --header 'Authorization: <authorization>'

200

{
  "data": [
    {}
  ],
  "meta.count": 123
}

Returns an array of full L2 orderbook snapshots between since and until. Useful for replaying market state over time.

Authentication

Authorization · string · required

Bearer pd_live_xxxxx

Query Parameters

asset_id · string · required

Outcome token ID

since · number · required

Start time (Unix ms)

until · number · required

End time (Unix ms)

limit · number · default: "100"

Max snapshots to return (1-1000)

Response

data · array

Array of orderbook snapshots (same shape as GET /v1/orderbook)

meta.count · number

Number of snapshots returned

Example

curl "https://api.polydata.live/v1/orderbook/range?asset_id=xxx&since=1776240000000&until=1776243600000&limit=50" \
  -H "Authorization: Bearer pd_live_xxxxx"

Sample response

{
  "success": true,
  "data": [
    {
      "timestamp": 1776240015000,
      "asset_id": "13915689317269...",
      "best_bid": 0.502,
      "best_ask": 0.504,
      "bids": [...],
      "asks": [...]
    },
    {
      "timestamp": 1776240105000,
      "asset_id": "13915689317269...",
      "best_bid": 0.503,
      "best_ask": 0.505,
      "bids": [...],
      "asks": [...]
    }
  ],
  "meta": { "count": 50 }
}