--- title: "Lighter.xyz REST API | 0xArchive Docs" description: "Use Lighter.xyz REST routes for order books, trades, candles, L3 depth, prices, summaries, funding, and reconstruction-heavy history." canonical_url: "https://www.0xarchive.io/docs/rest-api/lighter/" markdown_url: "https://www.0xarchive.io/docs/rest-api/lighter.md" route: "/docs/rest-api/lighter" robots: "index, follow" generated_from: "prerendered_html" --- # 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](https://www.0xarchive.io/openapi.json) ## Lighter.xyz Lighter routes for market state, history, L3 depth, and reconstruction-heavy jobs. ### Lighter.xyz - Order Book GET `/v1/lighter/orderbook/:symbol` Copy 2 credit s Get current order book snapshot Parameters `symbol` path required Trading pair (e.g., BTC, ETH) `timestamp` query Unix timestamp in ms for historical snapshot `depth` query Number 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/history` Copy 10 credit s 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 `symbol` path required Trading pair (e.g., BTC, ETH) `start` query required Start timestamp in ms `end` query required End timestamp in ms `cursor` query Pagination cursor from previous response `limit` query Max results (default: 100, max: 1000) `depth` query Number of price levels per side. Tier limits: Free=20, Build=200, Pro=Full Depth, Enterprise=Full Depth `granularity` query Data 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/:symbol` Copy 2 credit s Get trade history with cursor pagination. Get trade history with cursor pagination. Data available from August 2025. Parameters `symbol` path required Trading pair (e.g., BTC, ETH) `start` query required Start timestamp in ms `end` query required End timestamp in ms `cursor` query Cursor from previous response (next_cursor) `limit` query Max 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/recent` Copy 1 credit Get most recent trades Parameters `symbol` path required Trading pair (e.g., BTC, ETH) `limit` query Number 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/instruments` Copy 1 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/:symbol` Copy 1 credit Get a single Lighter.xyz instrument by symbol Parameters `symbol` path required Trading 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/:symbol` Copy 2 credit s Get historical open interest data. Get historical open interest data. Data available from August 2025. Parameters `symbol` path required Trading pair (e.g., BTC, ETH) `start` query required Start timestamp in ms `end` query required End timestamp in ms `cursor` query Cursor from previous response (next_cursor) `limit` query Max results (default: 100, max: 1000) `interval` query Aggregation 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/current` Copy 1 credit Get current open interest for a symbol Parameters `symbol` path required Trading 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/:symbol` Copy 2 credit s Get historical funding rates. Get historical funding rates. Data available from August 2025. Parameters `symbol` path required Trading pair (e.g., BTC, ETH) `start` query required Start timestamp in ms `end` query required End timestamp in ms `cursor` query Cursor from previous response (next_cursor) `limit` query Max results (default: 100, max: 1000) `interval` query Aggregation 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/current` Copy 1 credit Get current funding rate for a symbol Parameters `symbol` path required Trading 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/:symbol` Copy 3 credit s 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 `symbol` path required Trading pair (e.g., BTC, ETH) `start` query required Start timestamp in ms `end` query required End timestamp in ms `interval` query Candle interval: 1m, 5m, 15m, 30m, 1h (default), 4h, 1d, 1w `cursor` query Pagination cursor from previous response `limit` query Max 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/:symbol` Copy 1 credit Check when data was last updated for each data type (orderbook, trades, funding, OI) for a specific Lighter.xyz coin. Parameters `symbol` path required Trading 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/:symbol` Copy 2 credit s 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 `symbol` path required Trading 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/:symbol` Copy 2 credit s 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 `symbol` path required Trading pair (e.g., BTC, ETH) `start` query Start timestamp (Unix ms or ISO 8601). Defaults to 24h ago. `end` query End timestamp (Unix ms or ISO 8601). Defaults to now. `interval` query Aggregation interval: 5m, 15m, 30m, 1h, 4h, 1d. When omitted, returns raw data. `limit` query Max results (default: 100, max: 1000) `cursor` query Pagination 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/:symbol` Copy 5 credit s 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 `symbol` path required Trading pair (e.g., BTC, ETH) `depth` query Number 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/history` Copy 10 credit s 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 `symbol` path required Trading pair (e.g., BTC, ETH) `start` query required Start timestamp in ms `end` query required End timestamp in ms `cursor` query Pagination cursor from previous response `limit` query Max results (default: 100, max: 1000) `depth` query Number 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 } } ```