Lighter - Liquidations

Get Lighter liquidation events

Get Lighter liquidation events in a bounded time range using cursor pagination. Lighter liquidations are available only from the start of live capture; no public historical backfill is available before that window. Explicit endpoint cost is 3 credits per request.

get/v1/lighter/liquidations/{symbol}

Request

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

Path parameters

symbolstring required
Example:BTC

Lighter market symbol.

Query parameters

integer

Unix milliseconds.

OR
string date-time

RFC 3339 instant.

Example:1767225600000

Start timestamp. Defaults depend on the route family. 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.

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 results (default: 100, max: 1000)

Response

Lighter liquidation events

successboolean

Example response

{
  "success": true,
  "data": [
    {
      "symbol": "BTC",
      "timestamp": 1785116108743,
      "timestamp_ms": 1767225600000,
      "transaction_time_us": 1785116108751813,
      "trade_id": 26144238102,
      "liquidation_type": "liquidation",
      "price": 64921.9,
      "size": 0.18476,
      "usd_amount": 11994.970244,
      "ask_account": "728637",
      "bid_account": "726722",
      "ask_order_id": 562952982931319,
      "bid_order_id": 844421854021817,
      "taker_position_size_before": 0.19771,
      "maker_position_size_before": -1.85452,
      "taker_entry_quote_before": 12945.451185,
      "maker_entry_quote_before": 120665.315247,
      "taker_initial_margin_fraction_before": 200,
      "maker_initial_margin_fraction_before": 500,
      "taker_allocated_margin_usdc_before": 259232053,
      "taker_allocated_margin_usdc_after": 23859483,
      "taker_fee": 10000,
      "maker_fee": 28,
      "block_height": 300340672,
      "tx_hash": "000000198190c10e0000019fa13627c7000000000000000000000000000000000000000000000000",
      "source": "ws"
    }
  ],
  "meta": {
    "symbol": "BTC",
    "venue": "hyperliquid"
  }
}

Changes

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