Hyperliquid - Liquidations

Get Hyperliquid liquidation events

Get historical liquidation events for a coin. Served from December 22, 2025; older rows exist but are not served.

get/v1/hyperliquid/liquidations/{symbol}

Request

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

Path parameters

symbolstring required
Example:BTC

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

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 (format: timestamp_tradeId)

limitinteger

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

Response

Liquidation events

successboolean

Example response

{
  "success": true,
  "data": [
    {
      "symbol": "BTC",
      "coin": "BTC",
      "timestamp": "2025-05-21T10:30:00.000Z",
      "liquidated_user": "0x84eec0068b37919cc8f13d7454073ac167374cc0",
      "liquidator_user": "0x4d969e59b312970cc07af266938a4433ccae0b4c",
      "price": "42500.50",
      "size": "1.5",
      "side": "B",
      "mark_price": "42480.25",
      "closed_pnl": "-1250.50",
      "direction": "Close Long",
      "trade_id": 1234567890,
      "tx_hash": "0xe266d353038e679c5d7e042433054f0000e1d8e52f7860ecda84573b9b5a02ca"
    }
  ]
}

Changes

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