Lighter Historical Data API

Lighter coverage is schema-specific. Per-fill trade rows begin August 27, 2025; exact starts vary by market, and the rows carry maker/taker attribution. Funding and open interest have observed floors of August 25, 2025 at roughly 10-second resolution. Native L2 order books have an observed floor of January 29, 2026. Tick-level L3 individual-order depth starts March 5, 2026 with a cap of 250 orders per side. Lighter is not part of the Hyperliquid namespace. Keep Lighter symbols and routes separate from Hyperliquid core, Spot, HIP-3, and HIP-4. For a family-level view, see Lighter live and historical data, then return here for the route contract.

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	August 27, 2025; exact starts vary by market	Per-fill canonical records with maker/taker attribution
Funding and open interest	August 25, 2025 observed floor	Roughly 10-second rows
Order books (L2)	January 29, 2026 observed floor	Aggregated price-level snapshots; history granularity is route-specific
Order books (L3, individual orders)	March 5, 2026 observed floor	Tick-level individual resting orders, capped at 250 orders per side

Lighter per-fill trade rows begin August 27, 2025, and exact starts vary by market. L3 individual-order depth begins March 5, 2026 and is capped at 250 orders per side per tick. 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. L2 routes return aggregated price levels with px/sz decimal-string fields and n order counts. The L3 route returns individual resting orders with numeric order_index, owner_account_index, price, remaining_size, and original_size fields; it does not inherit the L2 px/sz level shape. Those index fields are numeric Lighter indexes, not wallet addresses or raw order IDs. Funding and open-interest routes use their documented resource shapes; do not assume they share an identical envelope or interval basis.

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

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