👥Cohorts

The Segments & Cohorts endpoints provide analytics on grouped wallet and position data. These allow for aggregating statistics across defined user or asset segments, viewing segment composition, and analyzing performance by cohort.

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 Cohorts

/api/external/segments

Returns every segment (cohort) that exists in the system along with the rules that define them. Each cohort includes its ID, name, category, and the criteria used to classify wallets or positions, such as size or PnL ranges. It only provides the segment definitions themselves, not the wallets inside them.

Request Examples

Curl

curl --request GET \
  --url 'https://ht-api.coinmarketman.com/api/external/segments?limit=20&orderBy=name&order=asc' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'

JavaScript

Python

Response

200 Success: Returns a list of available segments and their metadata.

Response Example

[
  {
    "id": 16,
    "name": "Shrimp",
    "category": "size",
    "criteria": {
      "minSize": 0,
      "maxSize": 250
    },
    "emoji": "🦐"
  },
  {
    "id": 1,
    "name": "Fish",
    "category": "size",
    "criteria": {
      "minSize": 250,
      "maxSize": 10000
    },
    "emoji": "🐟"
  },
  {
    "id": 2,
    "category": "size",
    "name": "Dolphin",
    "criteria": {
      "minSize": 10000,
      "maxSize": 50000
    },
    "emoji": "🐬"
  },
  {
    "id": 3,
    "category": "size",
    "name": "Apex Predator",
    "criteria": {
      "minSize": 50000,
      "maxSize": 100000
    },
    "emoji": "🦈"
  },
  {
    "id": 4,
    "category": "size",
    "name": "Small Whale",
    "criteria": {
      "minSize": 100000,
      "maxSize": 500000
    },
    "emoji": "🐋"
  },
  {
    "id": 5,
    "category": "size",
    "name": "Whale",
    "criteria": {
      "minSize": 500000,
      "maxSize": 1000000
    },
    "emoji": "🐳"
  },
  {
    "id": 6,
    "category": "size",
    "name": "Tidal Whale",
    "criteria": {
      "minSize": 1000000,
      "maxSize": 5000000
    },
    "emoji": "🌊"
  },
  {
    "id": 7,
    "category": "size",
    "name": "Leviathan",
    "criteria": {
      "minSize": 5000000
    },
    "emoji": "🐉"
  },
  {
    "id": 8,
    "category": "pnl",
    "name": "Money Printer",
    "criteria": {
      "minPnl": 1000000
    },
    "emoji": "💰"
  },
  {
    "id": 9,
    "category": "pnl",
    "name": "Smart Money",
    "criteria": {
      "minPnl": 100000,
      "maxPnl": 1000000
    },
    "emoji": "📈"
  },
  {
    "id": 10,
    "category": "pnl",
    "name": "Consistent Grinder",
    "criteria": {
      "minPnl": 10000,
      "maxPnl": 100000
    },
    "emoji": "📊"
  },
  {
    "id": 11,
    "category": "pnl",
    "name": "Humble Earner",
    "criteria": {
      "minPnl": 0,
      "maxPnl": 10000
    },
    "emoji": "🙏"
  },
  {
    "id": 12,
    "category": "pnl",
    "name": "Exit Liquidity",
    "criteria": {
      "minPnl": -10000,
      "maxPnl": 0
    },
    "emoji": "🤡"
  },
  {
    "id": 13,
    "category": "pnl",
    "name": "Semi-Rekt",
    "criteria": {
      "minPnl": -100000,
      "maxPnl": -10000
    },
    "emoji": "🔥"
  },
  {
    "id": 14,
    "category": "pnl",
    "name": "Full Rekt",
    "criteria": {
      "minPnl": -1000000,
      "maxPnl": -100000
    },
    "emoji": "🚨"
  },
  {
    "id": 15,
    "category": "pnl",
    "name": "Giga-Rekt",
    "criteria": {
      "maxPnl": -1000000
    },
    "emoji": "💀"
  }
]

---

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 Cohort Summary

/api/external/segments/{segmentId}/summary

Returns metadata and aggregate statistics for a specific trader segment (cohort). The response includes the cohort definition (name, category, emoji, and criteria thresholds), a snapshot summary of currently open perpetual positions for traders in that cohort, and the top 10 open perp assets by activity/value. It also includes the current trader count in the cohort and the trader count from 24 hours ago for quick comparison. Use the optional positionAge filter to scope the summary to wallets that opened at least one position within the selected timeframe. See Position Age Filter for details on how wallet eligibility works.

Path Parameters

Parameter	Type	Description
segmentId	string	The unique identifier of the cohort. See Legend.

Query Parameters

Parameter	Type	Description
positionAge	string	Filters the summary to wallets that have opened at least one position within the selected timeframe. Default: all. Available values: all, 24h, 7d, 30d.

Request Examples

Curl

curl -X GET \
  'https://ht-api.coinmarketman.com/api/external/segments/8/summary?positionAge=7d' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Python

Response

200 Success: Returns the requested segment profile and aggregated open perp statistics.

Response Example

{
  "segment": {
    "id": 8,
    "category": "pnl",
    "name": "Money Printer",
    "criteria": {
      "minPnl": 1000000
    },
    "emoji": "💰"
  },
  "openPerpsSummary": {
    "perpBias": -0.39,
    "exposureRatio": 1.91,
    "countOpenPositions": 4118,
    "countTradersInPosition": 222,
    "countTradersInProfit": 117,
    "totalValue": 2154803424.831947,
    "totalLongValue": 858695822.980287,
    "totalActivePerpEquity": 1129622467.533062,
    "bySide": [
      {
        "side": "long",
        "countOpenPositions": 1513,
        "totalValue": 858695822.980287
      },
      {
        "side": "short",
        "countOpenPositions": 2605,
        "totalValue": 1296107601.851660
      }
    ]
  },
  "summary": {
    "segmentId": 8,
    "countTradersInPosition": 222,
    "perpBias": -0.39,
    "positionValue": 2154803424.831947,
    "positionLongValue": 858695822.980287,
    "positionShortValue": 1296107601.851660,
    "exposureRatio": 1.91,
    "activePerpEquity": 1129622467.533062
  }
}

---

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 All Positions by Cohort (Opened/Closed)

/api/external/positions

Provides a complete historical record of every perpetual position opened or closed on Hyperliquid since April 4, 2025. Each entry includes the venue, symbol, size, cohort and direction, alongside full metrics for valuation and risk-checking like entry price, mark/mid pricing, leverage limits, and margin configuration.

Results also detail accumulated funding, unrealized PnL, and specific lifecycle timestamps where a null closeTime indicates an active position. Liquidation prices were only recorded at closure from April 4 to September 2, 2025, but have updated continuously at each block interval since then. Data for all requested addresses is paginated using the nextCursor field.

Query Parameters

Parameter	Type	Description
limit	number	Maximum number of positions to return per request.
coin	string	Coin symbol to filter by (for example ETH, BTC, LINEA). If omitted, positions for all coins are returned.
nextCursor	string	Cursor for pagination. Use the nextCursor value from the previous response to fetch the next page.
address	string	One or more wallet addresses to include.
start	string	Start of the time window (ISO 8601, UTC).
end	string	End of the time window (ISO 8601, UTC). If omitted, the API uses “now”.
open	boolean	Filter by position status. true returns only open positions, false returns only closed positions. If omitted, both are returned.
segmentId	number	Filter positions by trader segment (cohort). Available values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16. See Cohorts Legend.

Request Examples

Curl

curl --request GET \
  --url 'https://api.example.com/api/external/positions?limit=50&orderBy=pnl&order=desc' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'

JavaScript

Python

Response

200 Success: Returns a list of positions that match the provided filters. Pagination is supported via nextCursor.

Response Example

{
  "positions": [
    {
      "address": "0x00032b6993ba1276c206012d8af19dfba91d1406",
      "size": 1500,
      "entryPrice": 0.036802,
      "side": "long",
      "crossLeverage": 0,
      "maxLeverage": 3,
      "coin": "LINEA",
      "szDecimals": 0,
      "markPrice": 0.031922,
      "midPrice": 0.032114,
      "premiumPrice": -0.000511,
      "assetMaxLeverage": 3,
      "positionValue": 47.883,
      "liquidationPrice": 0.022345,
      "unrealizedPnl": -7.32,
      "funding": 0.014876,
      "openTime": "2025-09-01T10:12:30.000Z",
      "closeTime": null,
      "updatedAt": "2025-09-03T11:49:38.000Z",
      "createdAt": "2025-09-01T10:12:34.606Z",
      "isolatedLeverage": 3,
      "id": "d44ffdcce9eac1d533d783066ac58c8f14a6e7b4e7a4da4851b54607ce0033f1",
      "dex": "string",
      "profile": {
        "address": "0x31ca8395cf837de08b24da3f660e77761dfb974b",
        "segments": [
          7,
          8
        ]
      }
    }
  ],
  "nextCursor": "string"
}

---

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 Cohort Bias History

/api/external/segments/{segmentId}/bias-history

Returns a timestamped history of bias and exposure analytics for a single segment (cohort) over a defined time window. Each snapshot captures how the cohort was leaning at that point in time, including bias score, exposure ratio, open value, and active perp equity. Results are paginated using nextCursor and can be filtered by position recency timeframe.

Path Parameters

Parameter	Type	Description
segmentId	number	The unique identifier of the cohort. See Legend.

Query Parameters

Parameter	Type	Description
limit	number	Maximum number of positions to return per request.
nextCursor	string	Cursor for pagination. Use the nextCursor value from the previous response to fetch the next page.
start	string	Start of the time window (ISO 8601, UTC).
end	string	End of the time window (ISO 8601, UTC). If omitted, the API uses “now”.
positionRecencyTimeframe	string	Filters qualifying wallets by position recency. Default: all. Available values: 24h, 7d, 30d, all.

Request Examples

Curl

curl -X GET \
  'https://ht-api.coinmarketman.com/api/external/segments/12/bias-history?start=2026-03-03T08:10:00Z&end=2026-03-05T08:10:00Z&limit=25' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Python

Response

200 Success: Returns timestamped bias and exposure snapshots for the requested segment over the specified time window.

Reponse Example

{
    "segment": {
        "id": 12,
        "category": "pnl",
        "name": "Exit Liquidity",
        "criteria": {
            "minPnl": -10000,
            "maxPnl": 0
        },
        "emoji": "🤡"
    },
    "nextCursor": null,
    "positionRecencyTimeframe": "all",
    "start": "2026-03-03T08:10:00.099Z",
    "end": "2026-03-05T08:10:00.099Z",
    "pageStart": "2026-03-05T08:10:00.034Z",
    "pageEnd": "2026-03-03T08:10:00.388Z",
    "historySnapshotStructure": [
        "timestamp",
        "bias",
        "exposureRatio",
        "openValue",
        "openLongValue",
        "openShortValue",
        "activePerpEquity"
    ],
    "history": [
        [
            "2026-03-05T08:10:00.034Z",
            0.3,
            2.44,
            194847082.294877,
            109580377.574139,
            85266704.720738,
            80007378.282551
        ],
        [
            "2026-03-05T06:10:01.773Z",
            0.2,
            2.52,
            198221827.722323,
            107119584.704925,
            91102243.017398,
            78780069.4954
        ],
        [
            "2026-03-05T04:10:00.119Z",
            0.27,
            2.42,
            191692940.232117,
            106420025.551693,
            85272914.68042399,
            79225464.549207
        ],
        [
            "2026-03-05T02:10:00.055Z",
            0.25,
            2.48,
            203627561.476609,
            112140652.518944,
            91486908.957665,
            82004629.791395
        ],
        [
            "2026-03-05T00:10:00.030Z",
            0.21,
            2.41,
            190117541.873891,
            103161619.274356,
            86955922.599535,
            78939015.43056
        ],
        [
            "2026-03-04T22:10:00.187Z",
            0.29,
            2.5,
            194025268.851817,
            108404288.792581,
            85620980.059236,
            77621663.209369
        ],
        [
            "2026-03-04T20:10:00.034Z",
            0.2,
            2.37,
            196653548.905254,
            106601292.367679,
            90052256.537575,
            82936572.406612
        ],
        [
            "2026-03-04T18:10:00.090Z",
            0.22,
            2.42,
            194035865.801707,
            105984993.139062,
            88050872.662645,
            80248648.53197
        ],
        [
            "2026-03-04T16:10:00.038Z",
            0.43,
            2.36,
            191683529.189803,
            113397531.363046,
            78285997.826757,
            81111427.855888
        ],
        [
            "2026-03-04T14:10:00.027Z",
            0.4,
            2.33,
            185335272.373076,
            108556462.608365,
            76778809.764711,
            79565370.009556
        ],
        [
            "2026-03-04T12:10:00.035Z",
            0.38,
            2.37,
            181363955.740492,
            105177299.756005,
            76186655.98448698,
            76508127.783714
        ],
        [
            "2026-03-04T10:10:00.108Z",
            0.62,
            2.4,
            183646406.628479,
            115388093.122164,
            68258313.50631501,
            76401845.987983
        ],
        [
            "2026-03-04T08:10:00.075Z",
            0.7,
            2.34,
            176513343.623099,
            114759801.072524,
            61753542.550575,
            75594184.544043
        ],
        [
            "2026-03-04T06:10:00.019Z",
            0.85,
            2.34,
            190913461.466785,
            130247327.095513,
            60666134.37127201,
            81700192.72752
        ],
        [
            "2026-03-04T04:10:00.135Z",
            0.68,
            2.32,
            166654443.105801,
            107773694.369734,
            58880748.73606698,
            71816708.487044
        ],
        [
            "2026-03-04T02:10:00.051Z",
            0.66,
            2.41,
            177581347.704082,
            112931928.637331,
            64649419.06675102,
            73596135.66797
        ],
        [
            "2026-03-04T00:10:00.042Z",
            0.63,
            2.37,
            178573750.315158,
            112939042.264508,
            65634708.050650015,
            75199147.678786
        ],
        [
            "2026-03-03T22:10:00.499Z",
            0.55,
            2.37,
            174422170.294211,
            107365082.697163,
            67057087.597048,
            73733337.073643
        ],
        [
            "2026-03-03T20:10:00.034Z",
            0.65,
            2.41,
            182578253.876199,
            115926618.55302,
            66651635.32317901,
            75868522.460782
        ],
        [
            "2026-03-03T18:10:00.030Z",
            0.56,
            2.42,
            196300932.773859,
            120832768.963458,
            75468163.810401,
            80998828.619506
        ],
        [
            "2026-03-03T16:10:00.023Z",
            0.56,
            2.42,
            196300932.773859,
            120832768.963458,
            75468163.810401,
            80998828.619506
        ],
        [
            "2026-03-03T14:10:00.025Z",
            0.57,
            2.34,
            180507888.911894,
            112146761.878828,
            68361127.03306599,
            77016721.134604
        ],
        [
            "2026-03-03T12:10:00.021Z",
            0.72,
            2.5,
            196260066.210697,
            126214191.306251,
            70045874.90444599,
            78507018.610968
        ],
        [
            "2026-03-03T10:10:00.086Z",
            0.68,
            2.32,
            177693885.992653,
            114909537.460334,
            62784348.53231901,
            76539674.975133
        ],
        [
            "2026-03-03T08:10:00.388Z",
            0.32,
            2.44,
            193409212.340221,
            109311008.618172,
            84098203.72204898,
            79339689.7712
        ]
    ]
}

---

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 Position Breakdown by Cohort (Download File)

/api/external/exports/coins/{coin}/position-breakdown-by-cohort

Exports position breakdown by cohort for the selected coin, returning cohort-level metrics such as segment details, total position value, long position value, position count, value close to liquidation, bias, timestamp, and past comparison values.

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/position-breakdown-by-cohort' \
  --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",
  "cohortMetrics": [
    {
      "segment": {
        "id": 1,
        "name": "Fish",
        "category": "size",
        "criteria": {
          "minSize": 250,
          "maxSize": 10000
        },
        "emoji": "🐟"
      },
      "totalPositionValue": 28089.14192,
      "totalPositionValueLong": 21058.08792,
      "positionCount": 86,
      "valueCloseToLiquidation": 481.29432,
      "bias": 0.75,
      "timestamp": "2026-02-20T08:26:40.304Z",
      "pastPositionCount": 86,
      "pastTotalPositionValue": 28551.92666
    }
  ]
}

---

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 Cohort Metrics (Download File)

/api/external/exports/coins/{coin}/segment-metrics

Exports cohort metrics for the selected coin, returning metrics grouped by segment, with each segment including its metadata and timestamped values for position count, long position count, total position value, long position value, and bias. Each metrics object includes a columns array that defines the order of values in data for easy parsing and analysis.

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

Also found on 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/segment-metrics' \
  --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",
  "data": [
    {
      "segment": {
        "id": 16,
        "name": "Shrimp",
        "category": "size",
        "criteria": {
          "minSize": 0,
          "maxSize": 250
        },
        "emoji": "🦐"
      },
      "metrics": {
        "columns": [
          "positionCount",
          "positionCountLong",
          "totalPositionValue",
          "totalPositionValueLong",
          "bias",
          "timestamp"
        ],
        "data": [
          [
            28,
            16,
            905.00397,
            669.87089,
            0.74019,
            "2026-02-20T08:07:26.942Z"
          ],
          [
            30,
            15,
            969.4062,
            647.1234,
            0.66755,
            "2026-02-20T00:00:00.000Z"
          ]
        ]
      }
    },
    {
      "segment": {
        "id": 1,
        "name": "Fish",
        "category": "size",
        "criteria": {
          "minSize": 250,
          "maxSize": 10000
        },
        "emoji": "🐟"
      },
      "metrics": {
        "columns": [
          "positionCount",
          "positionCountLong",
          "totalPositionValue",
          "totalPositionValueLong",
          "bias",
          "timestamp"
        ],
        "data": [
          [
            87,
            53,
            34395.31862,
            27402.69337,
            0.7967,
            "2026-02-20T08:07:26.942Z"
          ],
          [
            87,
            57,
            32358.34099,
            28314.08797,
            0.87502,
            "2026-02-20T00:00:00.000Z"
          ]
        ]
      }
    }
  ]
}

---

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 Position Metrics by Coin and Segment (Cohort)

/api/external/position-metrics/coin/{coin}/segment/{segment}

Retrieves time-series position metrics for a specific coin within a specific segment (cohort) over a given time window. Use it to analyze how positioning and exposure for one cohort evolves on a single market, and paginate through longer ranges with nextCursor.

Also found on the Positions & Market Exposure subpage here.

Path Parameters

Parameter	Type	Description
coin	number	Coin ticker (for example BTC, ETH).
segment	number	Segment (cohort) key (path). Allowed values: 1 through 16. See Legend.

Query Parameters

Parameter	Type	Description
limit	number	Maximum number of metric rows to return in one response.
nextCursor	string	Cursor for pagination. Pass the value from the previous response to fetch the next page.
start	string	Start of the time window (ISO8601).
end	string	End of the time window (ISO8601).

Request Examples

Curl

curl --request GET \
  --url 'https://ht-api.coinmarketman.com/api/external/position-metrics/coin/BTC/segment/1' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --get \
  --data-urlencode 'start=2026-02-01T00:00:00Z' \
  --data-urlencode 'end=2026-02-13T00:00:00Z' \
  --data-urlencode 'limit=500'

Python

Response

200 Success: Returns an array of position metric rows plus nextCursor when more results are available.

Response Example

{
  "metrics": [
    {
      "id": 82430889,
      "createdAt": "2026-02-13T12:14:56.318Z",
      "coin": "BTC",
      "segmentId": 1,
      "positionCount": 10479,
      "positionCountLong": 4357,
      "totalPositionValue": 51302198.16585,
      "totalPositionValueLong": 29264758.38405,
      "totalFunding": 123955.175268,
      "totalUnrealizedPnl": -987205.028813,
      "totalPositionSize": 766.33353,
      "totalPositionSizeLong": 437.14629
    }
  ],
  "nextCursor": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTEzVDEyOjE0OjU2LjMxOFoi...snip..."
}

---

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 Positions Heatmap

/api/external/positions/heatmap

Retrieves a heatmap style overview of open positions across all coins and trader segments (cohorts). This gives you a quick visual snapshot of where different trader groups are positioned, how much value they hold, and whether they are leaning long or short across the market.

Also found on the Positions & Market Exposure subpage here.

Query Parameters

Parameter	Type	Description
openedWithin	string	Data aggregation period (24h/7d/30d/All).

Request Examples

Curl

curl --request GET \
  --url 'https://ht-api.coinmarketman.com/api/external/positions/heatmap?' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'

Python

Response

200 Success: Returns an aggregated positional heatmap across coins and segments.

Response Example

{
  "heatmap": [
    {
      "coin": "BTC",
      "totalValue": 1243320305.98032,
      "totalLongValue": 621660152.99016,
      "totalShortValue": 621660152.99016,
      "count": 23755,
      "countLong": 12046,
      "countShort": 11709,
      "segments": [
        {
          "segmentId": 1,
          "coin": "BTC",
          "totalValue": 50578304.39256,
          "totalLongValue": 31057906.48644,
          "totalShortValue": 19520397.90612,
          "count": 10591,
          "countLong": 4453,
          "countShort": 6138,
          "bias": 0.614
        },
        {
          "segmentId": 2,
          "coin": "BTC",
          "totalValue": 82235872.88154,
          "totalLongValue": 51144361.7391,
          "totalShortValue": 31091511.14244,
          "count": 1980,
          "countLong": 977,
          "countShort": 1003,
          "bias": 0.622
        },
        {
          "segmentId": 3,
          "coin": "BTC",
          "totalValue": 53930470.0557,
          "totalLongValue": 33190292.6874,
          "totalShortValue": 20740177.3683,
          "count": 456,
          "countLong": 253,
          "countShort": 203,
          "bias": 0.615
        },
        {
          "segmentId": 4,
          "coin": "BTC",
          "totalValue": 218354840.14002,
          "totalLongValue": 113557349.3616,
          "totalShortValue": 104797490.77842002,
          "count": 629,
          "countLong": 333,
          "countShort": 296,
          "bias": 0.52
        },
        {
          "segmentId": 5,
          "coin": "BTC",
          "totalValue": 149753709.366,
          "totalLongValue": 55638746.9052,
          "totalShortValue": 94114962.46079999,
          "count": 136,
          "countLong": 66,
          "countShort": 70,
          "bias": 0.372
        },
        {
          "segmentId": 6,
          "coin": "BTC",
          "totalValue": 371389788.6864,
          "totalLongValue": 180054848.64,
          "totalShortValue": 191334940.0464,
          "count": 151,
          "countLong": 73,
          "countShort": 78,
          "bias": 0.485
        },
        {
          "segmentId": 7,
          "coin": "BTC",
          "totalValue": 313267677.67278,
          "totalLongValue": 154900258.9893,
          "totalShortValue": 158367418.68347996,
          "count": 51,
          "countLong": 26,
          "countShort": 25,
          "bias": 0.494
        },
        {
          "segmentId": 8,
          "coin": "BTC",
          "totalValue": 567511203.08982,
          "totalLongValue": 217591542.0555,
          "totalShortValue": 349919661.03432,
          "count": 171,
          "countLong": 56,
          "countShort": 115,
          "bias": 0.383
        },
        {
          "segmentId": 9,
          "coin": "BTC",
          "totalValue": 148321210.36548,
          "totalLongValue": 47414529.32316,
          "totalShortValue": 100906681.04232001,
          "count": 405,
          "countLong": 177,
          "countShort": 228,
          "bias": 0.32
        },
        {
          "segmentId": 10,
          "coin": "BTC",
          "totalValue": 69308011.59918,
          "totalLongValue": 30717534.0156,
          "totalShortValue": 38590477.58358,
          "count": 737,
          "countLong": 299,
          "countShort": 438,
          "bias": 0.443
        },
        {
          "segmentId": 11,
          "coin": "BTC",
          "totalValue": 32289017.87934,
          "totalLongValue": 15882832.30674,
          "totalShortValue": 16406185.5726,
          "count": 8415,
          "countLong": 2010,
          "countShort": 6405,
          "bias": 0.492
        },
        {
          "segmentId": 12,
          "coin": "BTC",
          "totalValue": 42878145.22326,
          "totalLongValue": 28929977.72274,
          "totalShortValue": 13948167.500520002,
          "count": 12124,
          "countLong": 8146,
          "countShort": 3978,
          "bias": 0.675
        },
        {
          "segmentId": 13,
          "coin": "BTC",
          "totalValue": 102777324.84714,
          "totalLongValue": 73056598.58082,
          "totalShortValue": 29720726.266320005,
          "count": 1403,
          "countLong": 1001,
          "countShort": 402,
          "bias": 0.711
        },
        {
          "segmentId": 14,
          "coin": "BTC",
          "totalValue": 148183814.83722,
          "totalLongValue": 97583811.33984,
          "totalShortValue": 50600003.49738002,
          "count": 421,
          "countLong": 296,
          "countShort": 125,
          "bias": 0.659
        },
        {
          "segmentId": 15,
          "coin": "BTC",
          "totalValue": 132049373.17764,
          "totalLongValue": 110481272.11506,
          "totalShortValue": 21568101.062580004,
          "count": 76,
          "countLong": 59,
          "countShort": 17,
          "bias": 0.837
        },
        {
          "segmentId": 16,
          "coin": "BTC",
          "totalValue": 3807437.82408,
          "totalLongValue": 2114332.65042,
          "totalShortValue": 1693105.1736600003,
          "count": 9758,
          "countLong": 5863,
          "countShort": 3895,
          "bias": 0.555
        }
      ]
    }
  ]
}

---

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 Positions & Market Exposure 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 Cohort Bias (Download File)

/api/external/exports/segments-bias-charts-data-24h

Returns a 302 redirect to a short-lived download link so you can fetch an export file directly from S3. The export includes segment bias chart data over time (showing whether a segment is leaning more long or short at each timestamp). The columns field tells you what each value in the data rows represents, so the file can be used easily in charts or reports. The download link expires quickly (about 120 seconds), so it should be used shortly after it is returned.

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

Also found on the Downloadable Files subpage here.

Request Examples

Curl

curl --request GET \
  --url 'https://ht-api.coinmarketman.com/api/external/exports/segments-bias-charts-data-24h' \
  --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

[
  {
    "segmentId": 1,
    "columns": [
      "timestamp",
      "bias"
    ],
    "data": [
      [
        "2026-02-10T11:38:46.946Z",
        0.36
      ],
      [
        "2026-02-10T12:36:57.167Z",
        0.3
      ],
      [
        "2026-02-10T13:37:53.142Z",
        0.33
      ],
      [
        "2026-02-10T18:46:42.107Z",
        0.82
      ],
      [
        "2026-02-11T13:44:26.315Z",
        0.66
      ],
      [
        "2026-02-13T10:36:33.741Z",
        0.25
      ]
    ]
  },
  {
    "segmentId": 2,
    "columns": [
      "timestamp",
      "bias"
    ],
    "data": [
      [
        "2026-02-10T11:38:46.946Z",
        -0.13
      ],
      [
        "2026-02-10T12:36:57.167Z",
        -0.03
      ],
      [
        "2026-02-10T18:46:42.107Z",
        0.27
      ],
      [
        "2026-02-13T10:36:33.741Z",
        0.17
      ]
    ]
  },
  {
    "segmentId": 16,
    "columns": [
      "timestamp",
      "bias"
    ],
    "data": [
      [
        "2026-02-10T11:38:46.946Z",
        0.99
      ],
      [
        "2026-02-10T13:37:53.142Z",
        2.14
      ],
      [
        "2026-02-13T10:36:33.741Z",
        0.5
      ]
    ]
  }
]