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. Snapshots are checkpoints; 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

integer

Unix milliseconds.

OR
string date-time

RFC 3339 instant.

Example:1767225600000

Start timestamp. Defaults to 24 hours before the request. Accepts Unix milliseconds or an RFC 3339 UTC string such as 2026-01-01T00:00:00Z.

integer

Unix milliseconds.

OR
string date-time

RFC 3339 instant.

Example:1767225600000

End timestamp. Defaults to now. Accepts Unix milliseconds or an RFC 3339 UTC string such as 2026-01-01T00:00:00Z.

cursorstring

Opaque pagination cursor: pass meta.next_cursor from the previous page unchanged, with the same filters. Omit it for the first page.

limitinteger

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

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
    }
  ],
  "meta": {
    "symbol": "BTC",
    "venue": "hyperliquid"
  }
}

Changes

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