Lighter - L3 Order Book

Get Lighter L3 orderbook history

Get historical Lighter L3 order-level snapshots with price, remaining size, order_index, and owner_account_index. The public checkpoint-history response is an array of snapshots; each snapshot returns up to 250 resting orders per side. Optional granularity selects checkpoint, 30s, 10s, 1s, or tick resolution (checkpoint default); optional account filters by numeric account index. Data available from March 2026.

get/v1/lighter/l3orderbook/{symbol}/history

Request

  • Base URL: https://api.0xarchive.io
  • URL: https://api.0xarchive.io/v1/lighter/l3orderbook/{symbol}/history
  • Auth: API key in header X-API-Key

Path parameters

symbolstring required
Example:BTC

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

Query parameters

startinteger
Example:1773273600000

Start timestamp in Unix milliseconds. Defaults to 24 hours before the request. ISO 8601 strings are rejected.

endinteger
Example:1773273900000

End timestamp in Unix milliseconds. Defaults to now. ISO 8601 strings are rejected.

cursorinteger

Timestamp cursor in Unix milliseconds from the previous response metadata.

limitinteger

Maximum number of snapshots per response; effective values are clamped to 1–1000 (default: 100).

granularity'checkpoint' | '30s' | '10s' | '1s' | 'tick'

Optional history resolution. Canonical values are checkpoint (default), 30s, 10s, 1s, and tick.

accountinteger
Example:281474976710654

Optional numeric Lighter account index filter.

Response

Typed historical L3 orderbook snapshot array

successboolean required

Example response

{
  "success": true,
  "data": [
    {
      "coin": "BTC",
      "timestamp": "2026-03-12T00:00:00.000Z",
      "orders": [
        {
          "order_index": 562953074779869,
          "owner_account_index": 281474976710654,
          "side": "bid",
          "price": 65127.5,
          "remaining_size": 0.02303,
          "original_size": 0.02303
        }
      ],
      "bid_count": 250,
      "ask_count": 250,
      "total_bid_size": 102.34,
      "total_ask_size": 98.76,
      "mid_price": "65127.25",
      "spread": "0.50",
      "spread_bps": "0.08",
      "truncated": true
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.