Get Lighter L3 orderbook

curl --request GET \
  --url https://api.0xarchive.io/v1/lighter/l3orderbook/{symbol} \
  --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}', 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}"

	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}

Get Lighter L3 orderbook

curl --request GET \
  --url https://api.0xarchive.io/v1/lighter/l3orderbook/{symbol} \
  --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}', 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}"

	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

timestamp

integer<int64>

Unix timestamp in milliseconds for the requested Lighter snapshot. If omitted, returns the latest snapshot. ISO 8601 strings are rejected.

Example:

1773273600000

account

integer<int64>

Optional numeric Lighter account index filter.

Example:

281474976710654

depth

integer<int64>

Optional maximum number of resting orders returned per side. Values are clamped to the 1–250 ingestion cap.

Example:

50

Response

Typed L3 orderbook snapshot

success

boolean

required

Example:

true

data

object

required

Current or historical Lighter L3 orderbook snapshot.

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

Authorizations

Path Parameters

Query Parameters

Response