Skip to main content
GET
Get Lighter order book history

Authorizations

X-API-Key
string
header
required

API key for authentication. Get yours at https://0xarchive.io/dashboard

Path Parameters

symbol
string
required

Trading pair symbol (e.g., ETH, BTC)

Example:

"ETH"

Query Parameters

start
integer<int64>

Start timestamp in Unix milliseconds. Defaults to 24h ago.

end
integer<int64>

End timestamp in Unix milliseconds. Defaults to now.

cursor
integer<int64>

Cursor for pagination

limit
integer
default:100

Maximum number of results (default: 100, max: 1000)

Required range: x <= 1000
depth
integer

Number of price levels per side. Full depth available.

granularity
enum<string>
default:checkpoint

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.

Available options:
checkpoint,
30s,
10s,
1s,
tick

Response

List of order book snapshots

success
boolean
Example:

true

data
object[]
meta
object

Response metadata

Last modified on August 13, 2026