Get Hyperliquid liquidation levels

curl --request GET \
  --url https://api.0xarchive.io/v1/hyperliquid/liquidations/{symbol}/levels \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://api.0xarchive.io/v1/hyperliquid/liquidations/{symbol}/levels"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.0xarchive.io/v1/hyperliquid/liquidations/{symbol}/levels', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.0xarchive.io/v1/hyperliquid/liquidations/{symbol}/levels"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "success": true,
  "data": {
    "mid_price": 64234,
    "snapshot_ts": "2026-08-06 13:20:14.000",
    "block_number": 1100170000,
    "total_long": 826442891,
    "total_short": 940536199.24,
    "flagged_notional": 121607711.81,
    "levels": [
      {
        "price": 63655.89,
        "long_notional": 7411401.14,
        "short_notional": 0,
        "long_count": 190,
        "short_count": 0
      },
      {
        "price": 63784.36,
        "long_notional": 6715249.11,
        "short_notional": 0,
        "long_count": 458,
        "short_count": 0
      },
      {
        "price": 63912.83,
        "long_notional": 4028699.95,
        "short_notional": 0,
        "long_count": 344,
        "short_count": 0
      },
      {
        "price": 64041.3,
        "long_notional": 1387884.13,
        "short_notional": 0,
        "long_count": 171,
        "short_count": 0
      },
      {
        "price": 64169.77,
        "long_notional": 742482.09,
        "short_notional": 0,
        "long_count": 86,
        "short_count": 0
      },
      {
        "price": 64298.23,
        "long_notional": 0,
        "short_notional": 64234,
        "long_count": 0,
        "short_count": 1
      },
      {
        "price": 64426.7,
        "long_notional": 0,
        "short_notional": 0,
        "long_count": 0,
        "short_count": 0
      },
      {
        "price": 64555.17,
        "long_notional": 0,
        "short_notional": 0,
        "long_count": 0,
        "short_count": 0
      },
      {
        "price": 64683.64,
        "long_notional": 0,
        "short_notional": 0,
        "long_count": 0,
        "short_count": 0
      },
      {
        "price": 64812.11,
        "long_notional": 0,
        "short_notional": 0,
        "long_count": 0,
        "short_count": 0
      }
    ],
    "source": "raw"
  },
  "meta": {
    "count": 10,
    "request_id": "a1b2c3d4-e5f6-4789-8abc-def012345678"
  }
}

GET

https://api.0xarchive.io

hyperliquid

liquidations

{symbol}

levels

Get Hyperliquid liquidation levels

curl --request GET \
  --url https://api.0xarchive.io/v1/hyperliquid/liquidations/{symbol}/levels \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://api.0xarchive.io/v1/hyperliquid/liquidations/{symbol}/levels"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.0xarchive.io/v1/hyperliquid/liquidations/{symbol}/levels', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.0xarchive.io/v1/hyperliquid/liquidations/{symbol}/levels"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "success": true,
  "data": {
    "mid_price": 64234,
    "snapshot_ts": "2026-08-06 13:20:14.000",
    "block_number": 1100170000,
    "total_long": 826442891,
    "total_short": 940536199.24,
    "flagged_notional": 121607711.81,
    "levels": [
      {
        "price": 63655.89,
        "long_notional": 7411401.14,
        "short_notional": 0,
        "long_count": 190,
        "short_count": 0
      },
      {
        "price": 63784.36,
        "long_notional": 6715249.11,
        "short_notional": 0,
        "long_count": 458,
        "short_count": 0
      },
      {
        "price": 63912.83,
        "long_notional": 4028699.95,
        "short_notional": 0,
        "long_count": 344,
        "short_count": 0
      },
      {
        "price": 64041.3,
        "long_notional": 1387884.13,
        "short_notional": 0,
        "long_count": 171,
        "short_count": 0
      },
      {
        "price": 64169.77,
        "long_notional": 742482.09,
        "short_notional": 0,
        "long_count": 86,
        "short_count": 0
      },
      {
        "price": 64298.23,
        "long_notional": 0,
        "short_notional": 64234,
        "long_count": 0,
        "short_count": 1
      },
      {
        "price": 64426.7,
        "long_notional": 0,
        "short_notional": 0,
        "long_count": 0,
        "short_count": 0
      },
      {
        "price": 64555.17,
        "long_notional": 0,
        "short_notional": 0,
        "long_count": 0,
        "short_count": 0
      },
      {
        "price": 64683.64,
        "long_notional": 0,
        "short_notional": 0,
        "long_count": 0,
        "short_count": 0
      },
      {
        "price": 64812.11,
        "long_notional": 0,
        "short_notional": 0,
        "long_count": 0,
        "short_count": 0
      }
    ],
    "source": "raw"
  },
  "meta": {
    "count": 10,
    "request_id": "a1b2c3d4-e5f6-4789-8abc-def012345678"
  }
}

API key required. Send X-API-Key with this request. See REST authentication.

Operation schema

Shared request rules

Machine schema

Open the generated operation schema for machine-readable request and response details.

Authorizations

X-API-Key

string

header

required

API key for authentication. Get yours at https://0xarchive.io/dashboard

Headers

0xArchive-Version

enum<string>

Selects the 2026-10 response contract. Send 2026-10-01; any dated version on or after it selects the same shapes. Without the header every response keeps its existing shape. With it:

The data quality routes, /v1/status/coverage and /v1/symbols answer the standard {success, data, meta} envelope.
Record times that are integer milliseconds by default become RFC 3339 UTC strings with millisecond precision, and the integer moves to a *_ms field: L4 resting-order timestamp (timestamp_ms), CVD buckets, HIP-3 oracle reads, Lighter and Lighter on Robinhood Chain liquidations and liquidation volume. Levels and trigger-levels snapshot_ts become RFC 3339 with snapshot_ts_ms.
Error bodies carry the contract error_code names: invalid_parameter instead of invalid_query_params and invalid_path_params, historical_depth_exceeded instead of history_window_exceeded, and historical_range_exceeded instead of request_range_exceeded; a malformed cursor that fails to parse answers 400 invalid_cursor instead of invalid_query_params. With 0xArchive-Version: 2026-10-01, malformed cursors on trades, liquidations, L2 and L4 diffs, order history, TP/SL and order-flow routes answer 400 invalid_cursor. Without the header, the first six route families treat a malformed cursor as no cursor and return the first page; order flow answers 400 invalid_query_params. Malformed trade time inputs answer 400 invalid_time_range with the header and 400 invalid_query_params without it.

The response echoes the selected version in its own 0xArchive-Version header.

Available options:

2026-10-01

Example:

"2026-10-01"

Path Parameters

symbol

string

required

Trading pair symbol.

Example:

"BTC"

Query Parameters

range_pct

number

default:10

Percentage range around the snapshot mid/mark price. Clamped between 1 and 50. Default 10.

Required range: 1 <= x <= 50

buckets

integer

default:50

Number of price buckets. Clamped between 10 and 200. Default 50.

Required range: 10 <= x <= 200

side

enum<string>

Optional side filter. bid/buy/B keeps the long (or bid) side, ask/sell/A keeps the short (or ask) side; the other side is zeroed.

Available options:

bid,

ask,

buy,

sell,

B,

A

Point-in-time read. Serves the newest snapshot at or before this instant. Omit for the latest snapshot. History begins 2026-07-27; earlier instants return 404. Accepts Unix milliseconds or an RFC 3339 UTC string such as 2026-01-01T00:00:00Z. An instant: Unix milliseconds, or an RFC 3339 string such as 2026-01-01T00:00:00Z (encode a + offset as %2B). An unparsable value answers 400 invalid_time_range.

Example:

1767225600000

Response

Get Hyperliquid liquidation levels

API response containing projected forced-liquidation levels for one snapshot.

success

boolean

Example:

true

data

object

Projected forced-liquidation levels computed from clearinghouse positions and margin state (positions plus maintenance-margin tiers), aggregated into price buckets around the snapshot mark price. Snapshots are computed roughly every 5 minutes; snapshot_ts identifies the snapshot served.

Hide child attributes

data.mid_price

number

required

Mark price at the snapshot, center of the requested range.

Example:

64215

data.snapshot_ts

string

required

UTC snapshot time the levels reflect. Treat snapshots older than 2 hours as stale. By default a UTC string in YYYY-MM-DD HH:MM:SS.mmm form. With 0xArchive-Version: 2026-10-01 an RFC 3339 UTC string with millisecond precision, and snapshot_ts_ms carries the instant as Unix milliseconds.

data.block_number

integer<int64>

required

Hyperliquid block height the snapshot reflects.

data.total_long

number

required

Total long notional at risk across the whole book, not only the returned window.

data.total_short

number

required

Total short notional at risk across the whole book.

data.flagged_notional

number

required

Notional reported in totals but computed approximately or not assigned to a returned bucket. For HIP-3, cross-margined exposure is reported here and excluded from buckets.

data.source

enum<string>

required

Snapshot storage form used to answer the request. raw means query-time bins over stored fine-grained levels; histogram means proportional re-binning of a retained base histogram.

Available options:

raw,

histogram

data.levels

object[]

required

Hide child attributes

data.levels.price

number

required

Bucket center price.

data.levels.long_notional

number

required

USD notional of long positions projected to liquidate in this bucket.

data.levels.short_notional

number

required

USD notional of short positions projected to liquidate in this bucket.

data.levels.long_count

integer

required

Number of long positions in this bucket.

data.levels.short_count

integer

required

Number of short positions in this bucket.

data.snapshot_ts_ms

integer<int64>

With 0xArchive-Version: 2026-10-01 only: snapshot_ts as Unix milliseconds.

Example:

1767225600000

data.source_bin_width

number

Stored source-bin width in price units. Present only when source is histogram.

Endpoint reference

Requests and responses

Datasets

Venues

OpenAPI and schemas

Guides

Get Hyperliquid liquidation levels

Authorizations

Headers

Path Parameters

Query Parameters

Response