Historical orderbook

GET/data/orderbook

L2 orderbook snapshots from ClickHouse hot storage. Maximum 168-hour (7-day) query window per request.

120 requests / minute per key (read tier). Returns the {success, message, data} + meta envelope.

Authorizations

Authorizationstringheaderrequired

Bearer token - an ito_* key (from Settings) holding the markets:read scope.

Query parameters

venuestringrequired

One of: polymarket, kalshi, hyperliquid

market_idstring

Filter by market identifier (condition_id, ticker, etc.)

startstringrequired

ISO 8601 start timestamp

endstringrequired

ISO 8601 end timestamp

limitint

Max rows to return (default 5000, max 50000)

offsetint

Pagination offset (default 0)

Market price history

Bulk price history

Request

curl "https://itomarkets.com/api/v1/data/orderbook?venue=VALUE&start=VALUE&end=VALUE" \  -H "Authorization: Bearer $ITO_API_KEY"

ResponseJSON

{  "success": true,  "message": "Success",  "data": {    "venue": "polymarket",    "snapshots": [      {        "snapshot_ts": "2026-06-09T14:00:01",        "best_yes_bid": 0.6,        "best_yes_ask": 0.62,        "spread_bps": 33,        "venue": "polymarket"      }    ]  },  "meta": {    "rows": 1,    "limit": 5000,    "offset": 0,    "start": "2026-06-09T13:00:00+00:00",    "end": "2026-06-09T14:00:00+00:00"  }}