Pinax
    Hyperliquid perpetual exchange data endpoints, plus API documentation and monitoring.
    Resources & endpoints
    Hyperliquid Markets

    Market Liquidations

    PREVIEW

    Returns one row per liquidation event, aggregated across the multiple fills that walk the book during a liquidation. Only the liquidated user's side is returned; counterparty fills are excluded.

    Each row surfaces the coin, liquidated user, transaction hash, liquidation kind (CROSS_LONG, ISOLATED_SHORT, and others), total size and notional, size-weighted average fill price, the mark price at liquidation, and the liquidation method reported by the venue (backstop and others).

    Filter by coin, dex, and/or liquidated_user. Filters compose additively. Sort by notional (default, largest events first) or time (most recent first).

    GET
    https://api.pinax.network/v1/hyperliquid/markets/liquidations
    Requires bearer token — sign in to inject your team’s key.

    Optional parameters

    NameTypeDescription
    coin
    query
    		stringHyperliquid coin id. Perps: BTC. Spot: @N (@107). Builder DEXs: xyz:SILVER. Outcome coins (#N) are rejected — use /v1/hyperliquid/outcomes/*.
    Single value or array of values* (separate multiple values with ,)
    *Plan restricted.
    e.g. BTC
    dex
    query
    		Enum · 9DEX identifier. perps for core perps, spot for @N spot pairs, or a builder DEX name (xyz, cash, …). Outcome markets are served separately under /v1/hyperliquid/outcomes/*.
    Single value or array of values* (separate multiple values with ,)
    *Plan restricted.
    perpsspotxyzcashkmhynaflxvntlpara
    liquidated_user
    query
    		string · evm-addressFilter by address
    Single value or array of values* (separate multiple values with ,)
    *Plan restricted.
    e.g. 0xd8da6bf26964af9d7eed9e03e53415d37aa96045
    direction
    query
    		Enum · 7Restrict by liquidation kind. LIQUIDATED_CROSS_* / LIQUIDATED_ISOLATED_* cover margin-based liquidations; AUTO_DELEVERAGING is HL ADL; *_BORROW_LIQUIDATION covers borrow-side. Omit for all.
    Single value or array of values* (separate multiple values with ,)
    *Plan restricted.
    LIQUIDATED_CROSS_LONGLIQUIDATED_CROSS_SHORTLIQUIDATED_ISOLATED_LONGLIQUIDATED_ISOLATED_SHORTAUTO_DELEVERAGINGBACKSTOP_BORROW_LIQUIDATIONPARTIAL_BORROW_LIQUIDATION
    e.g. LIQUIDATED_CROSS_LONG
    sort_by
    query
    		Enum · 2
    notionaltime
    start_time
    query
    		DatetimeUNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).
    end_time
    query
    		DatetimeUNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).
    limit
    query
    		integerNumber of items* returned in a single request.
    *Plan restricted.
    page
    query
    		integerPage number to fetch.
    Empty data array signifies end of results.

    Response

    200 OK
    {
  "data": [
    {
      "block_num": 880714128,
      "timestamp": "2026-02-06 00:19:53",
      "event_hash": "0x37cd3a3ffeb5bee739460434c180bf000008522599b8ddb9db95e592bdb998d1",
      "coin": "BTC",
      "market_name": "BTC",
      "dex": "perps",
      "liquidated_user": "0x7ba283114573bde6fd304ad7b188a763e5402a52",
      "direction": "LIQUIDATED_CROSS_LONG",
      "liquidation_kind": "CROSS_LONG",
      "fills": 2,
      "total_size": 0.2203,
      "notional": 13116.86,
      "avg_fill_price": 59540.9,
      "mark_price": 60114,
      "liquidation_method": "backstop",
      "total_fees": 0
    }
  ]
}