Lighter - Trades

Get Lighter trades

Get historical trades (fills) for a coin within a time range. Served fill history begins January 17, 2025; exact starts vary by market.

Pagination: Use the cursor parameter with the value from the previous response's next_cursor for efficient pagination.

get/v1/lighter/trades/{symbol}

Request

  • Base URL: https://api.0xarchive.io
  • URL: https://api.0xarchive.io/v1/lighter/trades/{symbol}
  • Auth: API key in header X-API-Key

Path parameters

symbolstring required
Example:ETH

Trading pair symbol (e.g., ETH, BTC)

Query parameters

startinteger

Start timestamp in Unix milliseconds. Defaults to 24h ago.

endinteger

End timestamp in Unix milliseconds. Defaults to now.

cursorstring

Cursor for pagination

limitinteger

Maximum number of results (default: 100, max: 1000)

Response

List of trades with cursor for next page

successboolean

Example response

{
  "success": true,
  "data": [
    {
      "coin": "BTC",
      "symbol": "BTC",
      "side": "B",
      "price": "64708.5",
      "size": "0.00005",
      "timestamp": "2026-07-26T14:47:59.174Z",
      "tx_hash": "000000197b6fd6e90000019f9ee5a9c6000000000000000000000000000000000000000000000000",
      "trade_id": 26121110211,
      "order_id": 844421856609148,
      "fee": "0.000028",
      "account_index": "513030",
      "source": "bucket",
      "position_size_before": -0.94632,
      "position_size_after": -0.94627,
      "entry_quote_before": 61179.114686,
      "initial_margin_fraction_before": 0.02,
      "trade_type": "trade",
      "is_maker": true,
      "counterparty_address": "710765",
      "client_id": 46758119273906,
      "realized_pnl": -0.00295,
      "l2_block_height": 300075269,
      "transaction_time_us": 1785077279174437,
      "usdc_amount": 3.235425
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.