🌊Liquidation Data

The Liquidation Data endpoints give you structured access to liquidation risk and exposure data across the Hyperliquid ecosystem. These endpoints allow you to monitor where forced liquidations are most likely to occur, identify assets and cohorts under elevated pressure, and build a clearer picture of market-wide risk before it materializes.

Unique to HyperTracker Users

This endpoint is exclusive to HyperTracker, which independently aggregates and delivers this data beyond what’s available in the standard Hyperliquid API.

Get Liquidation Risk by Asset

api/external/{segmentId}/assets/liquidation-risk

Retrieves the percentage of open interest at high liquidation risk for each asset within a given segment (cohort). It shows how much of the total exposure is close to being liquidated. For example: If BTC has $1,000,000 in total open interest and $100,000 of that is within 75% of the liquidation threshold, then the liquidation risk by asset for XYZ is 10%.

The endpoint can return up to 500 results per request. Lower limits usually result in faster response times.

Also found on the Positions & Market Exposure subpage here and the Cohorts subpage here.

Understanding Liquidation Risk Liquidation risk indicates how close positions are to being liquidated. This data is crucial for monitoring market health and identifying potential cascading liquidation scenarios.

Path Parameters

Parameter	Type	Description
segmentId [required]	number	The cohort ID to analyze liquidation risk for. See Legend.

Query Parameters

Parameter	Type	Description
offset	number	The number of items to skip
limit	number	The maximum number of items to return

Request Examples

Curl

curl --request GET \
  --url 'https://ht-api.coinmarketman.com/api/external/5/assets/liquidation-risk?limit=50' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'

JavaScript

Python

Response

200 Success: Returns liquidation risk data by asset

Response Example

{
  "totalCount": 15,
  "items": [
    {
      "coin": "BTC",
      "totalValue": 100000,
      "riskValue": 25000,
      "percentRisk": 25
    },
    {
      "coin": "ETH",
      "totalValue": 75000,
      "riskValue": 18750,
      "percentRisk": 25
    }
  ]
}

---

Unique to HyperTracker Users

This endpoint is exclusive to HyperTracker, which independently aggregates and delivers this data beyond what’s available in the standard Hyperliquid API.

Get Liquidation Heatmap (Download File)

/api/external/exports/coins/{coin}/liquidation-heatmap

Exports liquidation heatmap data for the selected coin, returning price-bin ranges with liquidation value, position count, and the most impacted segment for each bin.

The download link expires quickly (about 120 seconds), so it should be used shortly after it is returned.

Also found on the Positions & Market Exposure subpage here and the Downloadable Files subpage here.

Path Parameters

Parameter	Type	Description
coin	string	Coin symbol (case-insensitive), for example BTC, ETH.

Request Examples

Curl

curl --request GET \
  --url 'https://ht-api.coinmarketman.com/api/external/exports/coins/BTC/liquidation-heatmap' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --location

Python

Response

200 Success: Redirects to a temporary pre-signed S3 URL for the requested export file.

Response Example

{
  "coin": "BTC",
  "heatmap": [
    {
      "coin": "BTC",
      "priceBinIndex": 0,
      "priceBinStart": 0,
      "priceBinEnd": 0.0040344,
      "liquidationValue": 377238.5892,
      "positionsCount": 121,
      "mostImpactedSegment": 8
    }
  ]
}

---