Skip to main content
GET
https://api.0xarchive.io
/
v1
/
lighter
/
orderbook
/
{symbol}
/
history
Get Lighter order book history
curl --request GET \
  --url https://api.0xarchive.io/v1/lighter/orderbook/{symbol}/history \
  --header 'X-API-Key: <api-key>'
{
  "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"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.0xarchive.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Get yours at https://www.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. Tier limits: Free=20, Build=200, Pro=Full Depth, Enterprise=Full Depth

​
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. Higher resolutions require higher tier plans. Credit multiplier: checkpoint=1x, 30s=2x, 10s=3x, 1s=10x, tick=20x. Note: When granularity=tick (Enterprise tier only), 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 May 20, 2026