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

startinteger

Start timestamp in Unix milliseconds. Defaults depend on the route family.

endinteger

End timestamp in Unix milliseconds. Defaults to now.

cursorstring

Cursor for pagination. Use the value from the previous response metadata.

limitinteger

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

Response

Lighter liquidation events

successboolean

Example response

{
  "success": true,
  "data": [
    {
      "symbol": "BTC",
      "timestamp": 1785116108743,
      "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"
    }
  ]
}

Changes

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