API reference
Public API/Backtesting

Read ATOP orderbook

GET/backtests/atop/orderbook

Pull a bounded sample from registered historical L2 datasets for inspection before replay.

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 backtests:read scope.

Query parameters

sourcestring

Dataset alias: platform_l2, kalshi_pmxt (default platform_l2)

venuestring

Filter by venue name

startstringrequired

ISO 8601 start timestamp

endstringrequired

ISO 8601 end timestamp

limitint

Max rows (default 5000, max 50000)

offsetint

Pagination offset (default 0)

Request
curl "https://itomarkets.com/api/v1/backtests/atop/orderbook?start=VALUE&end=VALUE" \  -H "Authorization: Bearer $ITO_API_KEY"
ResponseJSON
{  "success": true,  "message": "Success",  "data": {    "rows": [      {        "epoch": 1718010000,        "venue": "polymarket",        "best_bid": 0.6,        "best_ask": 0.62,        "spread_bps": 33      }    ],    "total": 1  },  "meta": {    "source": "platform_l2",    "limit": 5000,    "offset": 0  }}