Docs
⌘ K

Market Liquidations

GET/v1/hyperliquid/markets/liquidations

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

Query Parameters

ParameterDescriptionValue
coin
string

Hyperliquid coin identifier. Core perps have no prefix (BTC, HYPE); spot pairs use @N (@107); builder DEXs prefix the symbol with the DEX name (xyz:SILVER).

    dex
    string

    DEX identifier. perps for core perps, spot for @N spot pairs, or a builder DEX name (e.g. xyz, cash). New builder DEXs are added on Hyperliquid permissionlessly — call /v1/hyperliquid/dexes for the live set.

      liquidated_user
      string

      Filter by address

      • Accepted pattern: ^(0[xX])?[0-9a-fA-F]{40}$
      • Format: evm-address
      sort_by
      string
      • Default value: notional
      • Accepted values: notional, time
      notional
      start_time
      string

      UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

        end_time
        string

        UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

          limit
          integer

          Number of items* returned in a single request.
          *Plan restricted.

          • Default value: 10
          • Minimum value: 1
          • Maximum value: 1000
          page
          integer

          Page number to fetch.
          Empty data array signifies end of results.

          • Default value: 1
          • Minimum value: 1
          • Maximum value: 767465558638

          Potential Responses

          StatusDescription
          200

          Successful Response

          400

          Client side error

          401

          Authentication failed

          403

          Forbidden

          404

          Not found

          500

          Server side error