HIP-3 Builder Perps - Liquidations

Get HIP-3 liquidation events

Get liquidation-related fills for a HIP-3 symbol. Results can include liquidated-user rows plus counterparty/open-side rows. Coverage is symbol-specific; verify the selected market before choosing a time range.

get/v1/hyperliquid/hip3/liquidations/{symbol}

Request

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

Path parameters

symbolstring required
Example:hyna:BTC

HIP-3 trading pair symbol (e.g., hyna:BTC, km:US500). Case-sensitive.

Query parameters

startinteger required
Example:1769922000000

Start timestamp (Unix milliseconds)

endinteger

End timestamp (Unix milliseconds). Defaults to now.

cursorstring

Pagination cursor (format: {timestamp_ms}_{trade_id})

limitinteger

Maximum records to return (1-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.