Lighter

Lighter historical market data details - currency pairs, data coverage and data collection specifics

Lighter historical data is available since 2026-04-17.

Downloadable CSV files

Historical CSV datasets for the first day of each month are available to download without API key. See downloadable CSV files documentation.

Lighter data collection started after the April 2026 monthly sample date. Public monthly sample links will be available from the next first-day dataset.

API Access and data format

Historical data format is the same as provided by real-time Lighter WebSocket API with addition of local timestamps. Lighter symbols in Tardis.dev APIs are numeric market ids, for example 1 for a perpetual market and 2048 for a spot market. If you'd like to work with normalized data format instead (same format for each exchange) see downloadable CSV files or official client libs that can perform data normalization client-side.

# pip install tardis-dev
import asyncio
from tardis_dev import Channel, replay

async def main():
    async for local_timestamp, message in replay(
        exchange="lighter",
        from_date="2026-04-17",
        to_date="2026-04-18",
        filters=[Channel(name="order_book", symbols=["1"])],
        api_key="YOUR_API_KEY",
    ):
        # messages as provided by Lighter real-time stream
        print(message)

asyncio.run(main())

See Python client docs.

// npm install tardis-dev
import { replay } from 'tardis-dev';

const messages = replay({
  exchange: 'lighter',
  from: '2026-04-17',
  to: '2026-04-18',
  filters: [{ channel: 'order_book', symbols: ['1'] }],
  apiKey: 'YOUR_API_KEY'
});

// messages as provided by Lighter real-time stream
for await (const { localTimestamp, message } of messages) {
  console.log(localTimestamp, message);
}

See Node.js client docs.

curl --compressed -g 'https://api.tardis.dev/v1/data-feeds/lighter?from=2026-05-01&filters=[{"channel":"order_book","symbols":["1"]}]&offset=0'

See HTTP API docs.

curl -g 'localhost:8000/replay?options={"exchange":"lighter","filters":[{"channel":"order_book","symbols":["1"]}],"from":"2026-04-17","to":"2026-04-18"}'

Tardis-machine is a locally runnable server that exposes API allowing efficiently requesting historical market data for whole time periods in contrast to HTTP API that provides data only in minute by minute slices.

See tardis-machine docs.

Captured real-time channels

Click any channel below to see HTTP API response with historical data recorded for it.

order_book Order book snapshots and incremental updates stream
trade Trade executions stream including liquidation trades
ticker Best bid and offer updates stream
market_stats Perpetual market stats updates stream with mark price, index price, funding rate and open interest. Subscribed as market_stats/all.
spot_market_stats Spot market stats updates stream with index price, mid price, last trade price and 24h stats. Subscribed as spot_market_stats/all.

Market data collection details

Market data collection infrastructure for Lighter is located in GCP asia-northeast1 (Tokyo, Japan).

Real-time market data is captured via multiple WebSocket connections to wss://mainnet.zklighter.elliot.ai/stream.

PreviousHyperliquid NextHTX Coin-M Futures

Last updated 21 days ago

Was this helpful?

hashtagDownloadable CSV files

hashtagAPI Access and data format

hashtagCaptured real-time channels

hashtagMarket data collection details

Downloadable CSV files

API Access and data format

Captured real-time channels

Market data collection details