Hyperliquid - Liquidations

Get liquidations by user address

Get historical liquidation events for a specific user address. Returns liquidations where the user was the liquidated party. Served from December 22, 2025; older rows exist but are not served.

get/v1/hyperliquid/liquidations/user/{user}

Request

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

Path parameters

userstring required
Example:0x84eec0068b37919cc8f13d7454073ac167374cc0

User wallet address (e.g., 0x...)

Query parameters

startinteger

Start timestamp in Unix milliseconds. Defaults to 24h ago.

endinteger

End timestamp in Unix milliseconds. Defaults to now.

symbolstring

Optional symbol filter (e.g., BTC, ETH)

cursorstring

Cursor for pagination (timestamp in milliseconds)

limitinteger

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

Response

User 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.