Get Lighter L3 orderbook history

curl --request GET \
  --url https://api.0xarchive.io/v1/lighter/l3orderbook/{symbol}/history \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.0xarchive.io/v1/lighter/l3orderbook/{symbol}/history', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.0xarchive.io/v1/lighter/l3orderbook/{symbol}/history"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "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": {
    "count": 123,
    "next_cursor": "<string>",
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "coverage_from": "2023-11-07T05:31:56Z",
    "notice": "<string>"
  }
}

{
  "code": 400,
  "error": "Failed to deserialize query string: limit: invalid digit found in string",
  "error_code": "invalid_query_params",
  "request_id": "3f2a9c71-5b0e-4d68-9a4c-7e1d2b6f8a05"
}

{
  "code": 401,
  "error": "Missing or invalid API key. Provide X-API-Key header."
}

{
  "code": 429,
  "error": "Rate limit exceeded"
}

GET

https://api.0xarchive.io

lighter

l3orderbook

{symbol}

history

Get Lighter L3 orderbook history

curl --request GET \
  --url https://api.0xarchive.io/v1/lighter/l3orderbook/{symbol}/history \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.0xarchive.io/v1/lighter/l3orderbook/{symbol}/history', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.0xarchive.io/v1/lighter/l3orderbook/{symbol}/history"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "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": {
    "count": 123,
    "next_cursor": "<string>",
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "coverage_from": "2023-11-07T05:31:56Z",
    "notice": "<string>"
  }
}

{
  "code": 400,
  "error": "Failed to deserialize query string: limit: invalid digit found in string",
  "error_code": "invalid_query_params",
  "request_id": "3f2a9c71-5b0e-4d68-9a4c-7e1d2b6f8a05"
}

{
  "code": 401,
  "error": "Missing or invalid API key. Provide X-API-Key header."
}

{
  "code": 429,
  "error": "Rate limit exceeded"
}

API key required. Send X-API-Key with this request. See REST authentication.

Shared request rules

Machine schema

Open the generated operation schema for machine-readable request and response details.

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., BTC, ETH, SOL)

Example:

"BTC"

Query Parameters

start

integer<int64>

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

Example:

1773273600000

end

integer<int64>

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

Example:

1773273900000

cursor

integer<int64>

Timestamp cursor in Unix milliseconds from the previous response metadata.

limit

integer<int64>

default:100

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

Required range: x <= 1000

granularity

enum<string>

default:checkpoint

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

Available options:

checkpoint,

30s,

10s,

1s,

tick

account

integer<int64>

Optional numeric Lighter account index filter.

Example:

281474976710654

Response

Typed historical L3 orderbook snapshot array

success

boolean

required

Example:

true

data

object[]

required

Hide child attributes

data.coin

string

required

Lighter trading pair symbol.

Example:

"BTC"

data.timestamp

string<date-time>

required

Snapshot timestamp in UTC.

Example:

"2026-03-12T00:00:00.000Z"

data.orders

object[]

required

Individual resting orders in the served L3 view.

Hide child attributes

data.orders.order_index

integer<int64>

required

Numeric order index assigned by Lighter.

Example:

562953074779869

data.orders.owner_account_index

integer<int64>

required

Numeric Lighter account index associated with the resting order.

Example:

281474976710654

data.orders.side

enum<string>

required

Book side.

Available options:

bid,

ask

Example:

"bid"

data.orders.price

number

required

Lighter venue-native resting order price.

Example:

65127.5

data.orders.remaining_size

number

required

Remaining venue-native order size.

Example:

0.02303

data.orders.original_size

number

required

Original venue-native order size.

Example:

0.02303

data.bid_count

integer

required

Bid order count for the stored checkpoint view.

Example:

250

data.ask_count

integer

required

Ask order count for the stored checkpoint view.

Example:

250

data.total_bid_size

number

required

Aggregate remaining venue-native size across bids.

Example:

102.34

data.total_ask_size

number

required

Aggregate remaining venue-native size across asks.

Example:

98.76

data.mid_price

string | null

required

Mid price as a decimal string when both sides are present; null otherwise.

Example:

"65127.25"

data.spread

string | null

required

Absolute spread as a decimal string when both sides are present; null otherwise.

Example:

"0.50"

data.spread_bps

string | null

required

Spread in basis points as a decimal string when both sides are present; null otherwise.

Example:

"0.08"

data.truncated

boolean

required

True when the stored checkpoint reached the 250-orders-per-side ingestion cap.

Example:

true

API reference

SDKs & tooling

AI & agents

Get Lighter L3 orderbook history

Authorizations

Path Parameters

Query Parameters

Response