Get Lighter order book history

{ "success": true, "data": [ { "symbol": "BTC", "coin": "BTC", "timestamp": "2025-01-21T10:30:45.123Z", "bids": [ { "px": "42150.00", "sz": "1.5", "n": 15 } ], "asks": [ { "px": "42150.00", "sz": "1.5", "n": 15 } ], "mid_price": "42150.50", "spread": "1.00", "spread_bps": "2.37" } ], "meta": { "count": 123, "next_cursor": "<string>", "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a" } }

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[]

Hide child attributes

data.symbol

string

required

Trading pair symbol

Example:

"BTC"

data.coin

string

required

deprecated

Trading pair symbol (deprecated, use symbol instead)

Example:

"BTC"

data.timestamp

string<date-time>

required

Snapshot timestamp (UTC)

Example:

"2025-01-21T10:30:45.123Z"

data.bids

object[]

required

Bid price levels (best bid first)

Hide child attributes

data.bids.px

string

required

Price

Example:

"42150.00"

data.bids.sz

string

required

Total size at this price level

Example:

"1.5"

data.bids.n

integer

required

Number of orders at this level

Example:

15

data.asks

object[]

required

Ask price levels (best ask first)

Hide child attributes

data.asks.px

string

required

Price

Example:

"42150.00"

data.asks.sz

string

required

Total size at this price level

Example:

"1.5"

data.asks.n

integer

required

Number of orders at this level

Example:

15

data.mid_price

string

Mid price (best bid + best ask) / 2

Example:

"42150.50"

data.spread

string

Spread in absolute terms (best ask - best bid)

Example:

"1.00"

data.spread_bps

string

Spread in basis points

Example:

"2.37"