Lighter.xyz REST API

Lighter.xyz REST routes for order books, trades, candles, L3 depth, summary, prices, credits, and reconstruction-heavy history. 16 documented routes.

Routes
16 documented routes
Depth
L2 and L3 routes
History
Checkpoint and tick history
OpenAPI Spec

Lighter.xyz

Lighter routes for market state, history, L3 depth, and reconstruction-heavy jobs.

Lighter.xyz - Order Book

GET/v1/lighter/orderbook/:symbol2 credits

Get current order book snapshot

Parameters

symbolpathrequiredTrading pair (e.g., BTC, ETH)
timestampqueryUnix timestamp in ms for historical snapshot
depthqueryNumber of price levels per side. Tier limits: Free=20, Build=200, Pro=Full Depth, Enterprise=Full Depth

Request

/v1/lighter/orderbook/BTC?depth=50

Response

{
  "success": true,
  "data": {
    "symbol": "BTC",
    "timestamp": "2026-01-01T12:00:00Z",
    "bids": [
      {
        "px": "42150.50",
        "sz": "2.5",
        "n": 5
      }
    ],
    "asks": [
      {
        "px": "42151.00",
        "sz": "1.8",
        "n": 3
      }
    ],
    "mid_price": "42150.75",
    "spread": "0.50",
    "spread_bps": "1.19"
  },
  "meta": {
    "request_id": "req_abc123",
    "count": 1
  }
}
GET/v1/lighter/orderbook/:symbol/history10 credits

Get historical order book data with pagination.

Get historical order book data with pagination. Returns either tick-level events or sub-second snapshots depending on the granularity parameter — checkpoint (1-min, default), 30s, 10s, 1s, or tick (Enterprise; returns checkpoint + deltas for client-side reconstruction). Data available from January 2026.

Parameters

symbolpathrequiredTrading pair (e.g., BTC, ETH)
startqueryrequiredStart timestamp in ms
endqueryrequiredEnd timestamp in ms
cursorqueryPagination cursor from previous response
limitqueryMax results (default: 100, max: 1000)
depthqueryNumber of price levels per side. Tier limits: Free=20, Build=200, Pro=Full Depth, Enterprise=Full Depth
granularityqueryData resolution: checkpoint (1min, default), 30s, 10s, 1s, tick. Higher resolutions require higher tier plans. When granularity=tick (Enterprise only), response returns checkpoint + deltas for client-side reconstruction.

Request

/v1/lighter/orderbook/BTC/history?start=1704067200000&end=1704153600000&limit=100&granularity=10s&depth=50

Response

{
  "success": true,
  "data": [
    {
      "symbol": "BTC",
      "timestamp": "2026-01-01T12:00:00Z",
      "bids": [
        {
          "px": "42150.50",
          "sz": "2.5",
          "n": 5
        }
      ],
      "asks": [
        {
          "px": "42151.00",
          "sz": "1.8",
          "n": 3
        }
      ],
      "mid_price": "42150.75",
      "spread": "0.50"
    }
  ],
  "meta": {
    "request_id": "req_abc123",
    "count": 1,
    "next_cursor": "1704067200000_abc123",
    "has_more": false
  }
}

Lighter.xyz - Trades

GET/v1/lighter/trades/:symbol2 credits

Get trade history with cursor pagination.

Get trade history with cursor pagination. Data available from August 2025.

Parameters

symbolpathrequiredTrading pair (e.g., BTC, ETH)
startqueryrequiredStart timestamp in ms
endqueryrequiredEnd timestamp in ms
cursorqueryCursor from previous response (next_cursor)
limitqueryMax results (default: 100, max: 1000)

Request

/v1/lighter/trades/ETH?start=1704067200000&end=1704153600000&limit=1000

Response

{
  "success": true,
  "data": [
    {
      "symbol": "BTC",
      "timestamp": "2026-01-01T12:00:00Z",
      "side": "B",
      "price": "42150.50",
      "size": "0.25",
      "trade_id": 12345678,
      "direction": "Open Long"
    }
  ],
  "meta": {
    "request_id": "req_abc123",
    "count": 1,
    "next_cursor": "1704067200000_abc123",
    "has_more": false
  }
}
GET/v1/lighter/trades/:symbol/recent1 credit

Get most recent trades

Parameters

symbolpathrequiredTrading pair (e.g., BTC, ETH)
limitqueryNumber of trades to return (default: 100, max: 1000)

Request

/v1/lighter/trades/BTC/recent?limit=50

Response

{
  "success": true,
  "data": [
    {
      "symbol": "BTC",
      "timestamp": "2026-01-01T12:00:00Z",
      "side": "B",
      "price": "42150.50",
      "size": "0.25",
      "trade_id": 12345678,
      "direction": "Open Long"
    }
  ],
  "meta": {
    "request_id": "req_abc123",
    "count": 1,
    "next_cursor": "1704067200000_abc123",
    "has_more": false
  }
}

Lighter.xyz - Market Data

GET/v1/lighter/instruments1 credit

List all available Lighter.xyz trading instruments

Request

/v1/lighter/instruments

Response

{
  "success": true,
  "data": [
    {
      "symbol": "BTC",
      "exchange": "lighter",
      "quote": "USDC",
      "active": true
    },
    {
      "symbol": "ETH",
      "exchange": "lighter",
      "quote": "USDC",
      "active": true
    }
  ],
  "meta": {
    "request_id": "req_abc123",
    "count": 2
  }
}
GET/v1/lighter/instruments/:symbol1 credit

Get a single Lighter.xyz instrument by symbol

Parameters

symbolpathrequiredTrading pair (e.g., BTC, ETH)

Request

/v1/lighter/instruments/BTC

Response

{
  "success": true,
  "data": {
    "symbol": "BTC",
    "exchange": "lighter",
    "base": "BTC",
    "quote": "USDC",
    "active": true,
    "tick_size": "0.5",
    "lot_size": "0.001"
  },
  "meta": {
    "request_id": "req_abc123",
    "count": 1
  }
}
GET/v1/lighter/openinterest/:symbol2 credits

Get historical open interest data.

Get historical open interest data. Data available from August 2025.

Parameters

symbolpathrequiredTrading pair (e.g., BTC, ETH)
startqueryrequiredStart timestamp in ms
endqueryrequiredEnd timestamp in ms
cursorqueryCursor from previous response (next_cursor)
limitqueryMax results (default: 100, max: 1000)
intervalqueryAggregation interval: 5m, 15m, 30m, 1h, 4h, 1d. When omitted, returns raw ~1 min data.

Request

/v1/lighter/openinterest/BTC?start=1704067200000&end=1704153600000&limit=100

Response

{
  "success": true,
  "data": [
    {
      "symbol": "BTC",
      "timestamp": "2026-01-01T12:00:00Z",
      "open_interest": "12500.5",
      "mark_price": "42150.75"
    }
  ],
  "meta": {
    "request_id": "req_abc123",
    "count": 1,
    "next_cursor": "1704067200000_abc123",
    "has_more": false
  }
}
GET/v1/lighter/openinterest/:symbol/current1 credit

Get current open interest for a symbol

Parameters

symbolpathrequiredTrading pair (e.g., BTC, ETH)

Request

/v1/lighter/openinterest/BTC/current

Response

{
  "success": true,
  "data": {
    "symbol": "BTC",
    "timestamp": "2026-01-01T12:00:00Z",
    "open_interest": "12500.5",
    "mark_price": "42150.75"
  },
  "meta": {
    "request_id": "req_abc123",
    "count": 1
  }
}
GET/v1/lighter/funding/:symbol2 credits

Get historical funding rates.

Get historical funding rates. Data available from August 2025.

Parameters

symbolpathrequiredTrading pair (e.g., BTC, ETH)
startqueryrequiredStart timestamp in ms
endqueryrequiredEnd timestamp in ms
cursorqueryCursor from previous response (next_cursor)
limitqueryMax results (default: 100, max: 1000)
intervalqueryAggregation interval: 5m, 15m, 30m, 1h, 4h, 1d. When omitted, returns raw ~1 min data.

Request

/v1/lighter/funding/BTC?start=1704067200000&end=1704153600000&limit=100

Response

{
  "success": true,
  "data": [
    {
      "symbol": "BTC",
      "timestamp": "2026-01-01T12:00:00Z",
      "funding_rate": "0.0001",
      "premium": "0.00005"
    }
  ],
  "meta": {
    "request_id": "req_abc123",
    "count": 1,
    "next_cursor": "1704067200000_abc123",
    "has_more": false
  }
}
GET/v1/lighter/funding/:symbol/current1 credit

Get current funding rate for a symbol

Parameters

symbolpathrequiredTrading pair (e.g., BTC, ETH)

Request

/v1/lighter/funding/BTC/current

Response

{
  "success": true,
  "data": {
    "symbol": "BTC",
    "timestamp": "2026-01-01T12:00:00Z",
    "funding_rate": "0.0001",
    "premium": "0.00005"
  },
  "meta": {
    "request_id": "req_abc123",
    "count": 1
  }
}

Lighter.xyz - Candles

GET/v1/lighter/candles/:symbol3 credits

Get OHLCV candle data aggregated from trades.

Get OHLCV candle data aggregated from trades. Data available from August 2025. Supports cursor pagination for large datasets.

Parameters

symbolpathrequiredTrading pair (e.g., BTC, ETH)
startqueryrequiredStart timestamp in ms
endqueryrequiredEnd timestamp in ms
intervalqueryCandle interval: 1m, 5m, 15m, 30m, 1h (default), 4h, 1d, 1w
cursorqueryPagination cursor from previous response
limitqueryMax results (default: 100, max: 1000)

Request

/v1/lighter/candles/BTC?start=1704067200000&end=1704153600000&interval=15m&limit=100

Response

{
  "success": true,
  "data": [
    {
      "symbol": "BTC",
      "timestamp": "2026-01-01T12:00:00Z",
      "interval": "1h",
      "open": "42100.00",
      "high": "42200.00",
      "low": "42050.00",
      "close": "42180.00",
      "volume": "125.5"
    }
  ],
  "meta": {
    "request_id": "req_abc123",
    "count": 1,
    "next_cursor": "1704067200000_abc123",
    "has_more": false
  }
}

Lighter.xyz - Convenience

GET/v1/lighter/freshness/:symbol1 credit

Check when data was last updated for each data type (orderbook, trades, funding, OI) for a specific Lighter.xyz coin.

Parameters

symbolpathrequiredTrading pair (e.g., BTC, ETH)

Request

/v1/lighter/freshness/BTC

Response

{
  "success": true,
  "data": {
    "symbol": "BTC",
    "exchange": "lighter",
    "latest_timestamp": "2026-01-01T12:00:00Z",
    "lag_ms": 1200,
    "status": "fresh"
  },
  "meta": {
    "request_id": "req_abc123",
    "count": 1
  }
}
GET/v1/lighter/summary/:symbol2 credits

Get a combined market summary for a Lighter.xyz symbol in a single API call.

Get a combined market summary for a Lighter.xyz symbol in a single API call. Returns latest price, funding rate, and open interest.

Parameters

symbolpathrequiredTrading pair (e.g., BTC, ETH)

Request

/v1/lighter/summary/BTC

Response

{
  "success": true,
  "data": {
    "symbol": "BTC",
    "mark_price": "42150.75",
    "mid_price": "42150.75",
    "open_interest": "12500.5",
    "volume_24h": "1250000000",
    "timestamp": "2026-01-01T12:00:00Z"
  },
  "meta": {
    "request_id": "req_abc123",
    "count": 1
  }
}
GET/v1/lighter/prices/:symbol2 credits

Get mark and oracle price history for a Lighter.xyz symbol.

Get mark and oracle price history for a Lighter.xyz symbol. Lightweight projection of open interest data. Supports time aggregation intervals.

Parameters

symbolpathrequiredTrading pair (e.g., BTC, ETH)
startqueryStart timestamp (Unix ms or ISO 8601). Defaults to 24h ago.
endqueryEnd timestamp (Unix ms or ISO 8601). Defaults to now.
intervalqueryAggregation interval: 5m, 15m, 30m, 1h, 4h, 1d. When omitted, returns raw data.
limitqueryMax results (default: 100, max: 1000)
cursorqueryPagination cursor from previous response

Request

/v1/lighter/prices/BTC?start=1704067200000&end=1704153600000&interval=1h&limit=100

Response

{
  "success": true,
  "data": [
    {
      "symbol": "BTC",
      "timestamp": "2026-01-01T12:00:00Z",
      "mark_price": "42150.75",
      "oracle_price": "42148.50",
      "mid_price": "42150.75"
    }
  ],
  "meta": {
    "request_id": "req_abc123",
    "count": 1,
    "next_cursor": "1704067200000_abc123",
    "has_more": false
  }
}

Lighter.xyz - L3 Order Book (Order-Level)

GET/v1/lighter/l3orderbook/:symbol5 credits

Get current L3 order-level orderbook showing individual orders at each price level with order IDs and sizes.

Get current L3 order-level orderbook showing individual orders at each price level with order IDs and sizes. Requires Pro tier or higher.

Parameters

symbolpathrequiredTrading pair (e.g., BTC, ETH)
depthqueryNumber of price levels per side (default: 20)

Request

/v1/lighter/l3orderbook/BTC?depth=20

Response

{
  "success": true,
  "data": {
    "symbol": "BTC",
    "timestamp": "2026-01-01T12:00:00Z",
    "status": "ok"
  },
  "meta": {
    "request_id": "req_abc123",
    "count": 1
  }
}
GET/v1/lighter/l3orderbook/:symbol/history10 credits

Get historical L3 orderbook snapshots showing individual orders at each price level.

Get historical L3 orderbook snapshots showing individual orders at each price level. Data available from March 2026. Requires Pro tier or higher.

Parameters

symbolpathrequiredTrading pair (e.g., BTC, ETH)
startqueryrequiredStart timestamp in ms
endqueryrequiredEnd timestamp in ms
cursorqueryPagination cursor from previous response
limitqueryMax results (default: 100, max: 1000)
depthqueryNumber of price levels per side (default: 20)

Request

/v1/lighter/l3orderbook/BTC/history?start=1704067200000&end=1704153600000&limit=100&depth=20

Response

{
  "success": true,
  "data": {
    "symbol": "BTC",
    "timestamp": "2026-01-01T12:00:00Z",
    "status": "ok"
  },
  "meta": {
    "request_id": "req_abc123",
    "count": 1
  }
}