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

integer

Unix milliseconds.

OR
string date-time

RFC 3339 instant.

Example:1767225600000

Start timestamp. Defaults to 24h ago. Accepts Unix milliseconds or an RFC 3339 UTC string such as 2026-01-01T00:00:00Z.

integer

Unix milliseconds.

OR
string date-time

RFC 3339 instant.

Example:1767225600000

End timestamp. Defaults to now. Accepts Unix milliseconds or an RFC 3339 UTC string such as 2026-01-01T00:00:00Z.

side'buy' | 'sell'

Keep one side of the tape: buy or sell (case-insensitive). Omit it for both. The filter runs before paging, so a full page still holds limit matching trades and the cursor pages the filtered tape. Any other value answers 400 invalid_parameter with param and valid_values.

cursorstring

Opaque pagination cursor: pass meta.next_cursor from the previous page unchanged, with the same filters. Omit it for the first page.

limitinteger

Maximum number of trades (default: 100, max: 50000).

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
    }
  ],
  "meta": {
    "symbol": "BTC",
    "venue": "hyperliquid"
  }
}

Changes

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