Lighter on Robinhood Chain - Order Book

Get Lighter on Robinhood Chain order book history

Get historical Lighter on Robinhood Chain L2 order book snapshots within a time range with configurable resolution. History starts August 22, 2026 18:43 UTC at every granularity. Use the granularity parameter to control data resolution.

Tick-Level Data: When granularity=tick, the response format changes. Instead of returning snapshots in the data array, it returns:

  • checkpoint: Full orderbook state at the start of the time range
  • deltas: Array of incremental changes to apply to the checkpoint

This is the most efficient format for reconstructing high-frequency orderbook states. Use the SDK's OrderBookReconstructor class for client-side reconstruction.

get/v1/rh-lighter/orderbook/{symbol}/history

Request

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

Path parameters

symbolstring required
Example:BTC

Market symbol on Lighter on Robinhood Chain. Perpetuals use the uppercase base symbol (BTC); spot pairs are dashed and USDG-quoted (AAPL-USDG). List markets with GET /v1/rh-lighter/instruments.

Query parameters

startinteger

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

endinteger

End timestamp in Unix milliseconds. Defaults to now.

cursorinteger

Cursor for pagination

limitinteger

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

depthinteger

Requested price levels per side. The Lighter native L2 route includes all served levels.

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

Data resolution: checkpoint (1min, default), 30s, 10s, 1s, tick. History starts August 22, 2026 18:43 UTC at every granularity. 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.

Response

List of order book snapshots

successboolean

Example response

{
  "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"
    }
  ]
}

Changes

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