Get Lighter order book history
0xArchive API reference for Get Lighter order book history. Includes authentication, parameters, response shape, examples, and route-safe implementation notes.
X-API-Key with this request. See REST authentication.Machine schema
Machine schema
Authorizations
API key for authentication. Get yours at https://0xarchive.io/dashboard
Headers
Selects the 2026-10 response contract. Send 2026-10-01; any dated version on or after it selects the same shapes. Without the header every response keeps its existing shape. With it:
- The data quality routes,
/v1/status/coverageand/v1/symbolsanswer the standard{success, data, meta}envelope. - Record times that are integer milliseconds by default become RFC 3339 UTC strings with millisecond precision, and the integer moves to a
*_msfield: L4 resting-ordertimestamp(timestamp_ms), CVD buckets, HIP-3 oracle reads, Lighter and Lighter on Robinhood Chain liquidations and liquidation volume. Levels and trigger-levelssnapshot_tsbecome RFC 3339 withsnapshot_ts_ms. - Error bodies carry the contract
error_codenames:invalid_parameterinstead ofinvalid_query_paramsandinvalid_path_params,historical_depth_exceededinstead ofhistory_window_exceeded, andhistorical_range_exceededinstead ofrequest_range_exceeded; a malformed cursor that fails to parse answers 400invalid_cursorinstead ofinvalid_query_params. With0xArchive-Version: 2026-10-01, malformed cursors on trades, liquidations, L2 and L4 diffs, order history, TP/SL and order-flow routes answer 400invalid_cursor. Without the header, the first six route families treat a malformed cursor as no cursor and return the first page; order flow answers 400invalid_query_params. Malformed trade time inputs answer 400invalid_time_rangewith the header and 400invalid_query_paramswithout it.
The response echoes the selected version in its own 0xArchive-Version header.
2026-10-01 "2026-10-01"
Query Parameters
Start timestamp. Defaults to 24h ago. Accepts Unix milliseconds or an RFC 3339 UTC string such as 2026-01-01T00:00:00Z.
An instant: Unix milliseconds, or an RFC 3339 string such as 2026-01-01T00:00:00Z (encode a + offset as %2B). An unparsable value answers 400 invalid_time_range.
1767225600000
Data resolution: checkpoint (1min, default), 30s, 10s, 1s, tick. Checkpoint history starts January 29, 2026; 30s/10s/1s start January 30, 2026. Billed per row returned (about 1 credit per 1,000 rows, minimum 1 credit per request). Higher resolutions return more rows. Note: When granularity=tick, the response format changes to return checkpoint and deltas instead of a data array. 60s and 1m are accepted for checkpoint, and delta and deltas for tick. An unrecognised value is currently served as checkpoint.
checkpoint, 30s, 10s, 1s, tick Response
List of order book snapshots