Lighter Historical Data API

0xArchive covers more than 200 Lighter markets. Trade history reaches back to January 2025 for supported markets, with more than 2 billion records. Coverage varies by market. Funding and open interest reach back to August 2025, tick-level order books to January 2026, and L3 order-level depth to March 2026. Lighter is not part of the Hyperliquid namespace. Keep Lighter symbols and routes separate from Hyperliquid core, Spot, HIP-3, and HIP-4. Looking for the product view before choosing a route? Explore Lighter live and historical data, then come back here when you are ready to wire the first request.

curl "https://api.0xarchive.io/v1/lighter/trades/BTC?limit=100" \
  -H "X-API-Key: $OXARCHIVE_API_KEY"

{
  "success": true,
  "data": [
    {
      "coin": "BTC",
      "symbol": "BTC",
      "side": "A",
      "price": "65442.8",
      "size": "0.0002",
      "timestamp": "2026-07-26T23:05:57.077Z",
      "trade_id": 26136294050,
      "order_id": 562952982196387,
      "crossed": false,
      "fee": "0.000038",
      "source": "bucket",
      "account_index": "27927",
      "counterparty_address": "726974",
      "is_maker": true,
      "trade_type": "trade",
      "realized_pnl": 0.180501,
      "usdc_amount": 13.08856,
      "position_size_before": 35.42189,
      "position_size_after": 35.42169,
      "entry_quote_before": 2286139.183764,
      "initial_margin_fraction_before": 0.05,
      "position_sign_changed": false,
      "l2_block_height": 300252997,
      "tx_hash": "2d55b155242b14b30d24b334579614f4e1ee4c8c1311cf543a9833dd02a09e48b9994cb889e3dc6e"
    }
  ],
  "meta": {
    "count": 1,
    "next_cursor": "1785107157077_26136294050_0",
    "request_id": "006e289d-724f-47dc-a0e9-36fe00f5e25b",
    "finalized_through": "2026-07-27T14:47:59.159Z"
  }
}

Lighter REST

Lighter route family.

Lighter quickstart

First Lighter request.

What History Is Available

Route family	Earliest	Detail
Trades	As early as January 2025; varies by market	Per-trade canonical records; more than 2 billion records
Funding and open interest	August 2025	Per-interval history to the current hour
Order books (tick L2)	January 2026	Tick-level book updates; more than 39 billion records
Order books (L3, order-level)	March 2026	Per-order depth with owner account indexes

Lighter trade history is available as early as January 2025 for supported markets; coverage varies by market. Order-level (L3) detail begins March 2026. Hold one symbol and one UTC window constant on the first pull, then widen.

What Each Row Carries

Trade rows share the {success, data, meta} envelope used across the API, with cursor pagination through meta.next_cursor and a meta.request_id per page. Lighter trades are two-tier: /v1/lighter/trades/{symbol} serves canonical history reconciled daily from the Lighter Foundation archive (source: "bucket"), and /v1/lighter/trades/{symbol}/recent serves preliminary live rows (source: "ws"). Canonical rows carry the enrichment shown in the example above; preliminary rows are a smaller set of about 14 fields without fee, tx_hash, order_id, or realized_pnl.

Field	What it tells you
`symbol`	The Lighter market, such as `BTC`
`side`	`B` (buy) or `A` (sell)
`price` and `size`	Execution price and size, decimal strings
`timestamp`	Execution time, UTC
`trade_id`	Join key for deduplication and ordered playback
`source`	`bucket` for canonical rows, `ws` for preliminary rows
`account_index`, `counterparty_address`	Lighter account indexes (integer account ids as strings), not wallet addresses
`fee`, `realized_pnl`, `usdc_amount`, `tx_hash`, `order_id`, `l2_block_height`	Canonical-only enrichment; omitted when null
`position_size_before`, `position_size_after`, `entry_quote_before`, `initial_margin_fraction_before`	Position and margin state around the fill

History requests clamp to the daily finalization watermark: meta.finalized_through reports the latest finalized timestamp, and an end past it comes back with meta.requested_end and meta.clamped_to while the rows stay canonical only. Newer rows are on /recent, where meta.preliminary_row_count counts the preliminary rows served. Order-book routes return px/sz/n levels in the same shape as Hyperliquid L2, and the L3 route at /v1/lighter/l3orderbook/{symbol} returns individual resting orders rather than aggregated levels, the Lighter equivalent of Hyperliquid L4. Funding and open interest carry per-interval rows with the same envelope.

Implementation Pattern

Start with one Lighter symbol such as BTC, one route, and a small window. Check coverage and freshness before the output feeds a backtest, report, alert, or model. If a coding agent writes the client, give it OpenAPI plus Lighter REST so it keeps Lighter routes separate from Hyperliquid.

Next Step

Open Lighter REST, run the trade request above, then use Data quality and Venue coverage before widening to more markets. For a ranked read on Lighter coverage, see Best Lighter Data API.

Get started

Market data

Get connected

Plans & limits

Lighter Historical Data API

Lighter REST

Lighter quickstart

What History Is Available

What Each Row Carries

Implementation Pattern

Next Step

Lighter REST

Lighter quickstart

​What History Is Available

​What Each Row Carries

​Implementation Pattern

​Next Step

What History Is Available

What Each Row Carries

Implementation Pattern

Next Step