📁Downloadable Files

The Downloadable Files section provides access to downloadable export files and supporting resources across the platform. These files can be used to retrieve structured data, charts, analytics outputs, and other materials for external analysis, reporting, and workflow integration.

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 Total Wallets Equity Chart (Download File)

/api/external/exports/total-wallets-equity-chart-data

Exports Total Wallets Equity chart data including the all-time-high breakdown, the same breakdown from 24 hours earlier, and historical time-series values for total, perp, spot, staking, and vault equity. Each section includes a columns array that defines the order of values in data, and historical entries are returned with timestamps.

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

Also found on the Trader & Wallet subpage here.

Request Examples

Curl

curl --request GET \
  --url 'https://ht-api.coinmarketman.com/api/external/exports/total-wallets-equity-chart-data' \
  --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

{
  "athData": {
    "columns": [
      "totalWalletsEquity",
      "perpWalletsEquity",
      "spotWalletsEquity",
      "stakingWalletsEquity",
      "vaultWalletsEquity"
    ],
    "data": [
      39135688288.68,
      5797950036.25,
      7158433882.62,
      26054432372.03,
      1082356296.32
    ]
  },
  "data24HoursAgo": {
    "columns": [
      "totalWalletsEquity",
      "perpWalletsEquity",
      "spotWalletsEquity",
      "stakingWalletsEquity",
      "vaultWalletsEquity"
    ],
    "data": [
      19968765498.79,
      3665587337.68,
      2703007635.96,
      12908517799.43,
      691652725.73
    ]
  },
  "history": {
    "columns": [
      "timestamp",
      "totalWalletsEquity",
      "perpWalletsEquity",
      "spotWalletsEquity",
      "stakingWalletsEquity",
      "vaultWalletsEquity"
    ],
    "data": [
      [
        "2025-08-19T04:41:55.473Z",
        29020983042.1,
        4454362530.94,
        6057951439.58,
        18296312774.63,
        null
      ],
      [
        "2025-08-20T05:12:30.000Z",
        29500000000,
        4500000000,
        6100000000,
        18600000000,
        300000000
      ]
    ]
  }
}

---

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

Exports cohort bias time-series data grouped by segmentId, where each segment contains timestamped bias values. Each segment includes a columns array that defines the order of values in data, making the export easy to parse for charts, reporting, or analytics.

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

Also found on the Cohorts 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
      ]
    ]
  }
]

---

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 Liquidation subpage here and the Positions & Market Exposure 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
    }
  ]
}

---

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

/api/external/exports/coins/{coin}/positions

Exports position breakdown by size for a selected coin, returning size-segment metrics such as size range, position count, total position value, long position value, value close to liquidation, bias, and past comparison values, along with the export timestamp.

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.

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/positions' \
  --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",
  "positions": [
    {
      "id": "c5fb1399c4e1d185990629e7241d5a331f3739a401300d4579d3d38fff41f8c8",
      "side": "long",
      "address": "0x31ca8395cf837de08b24da3f660e77761dfb974b",
      "dex": "main",
      "value": 127216.0628,
      "size": 189197,
      "coin": "BTC",
      "entryPrice": 0.650849,
      "unrealizedPnl": 4077.405136,
      "funding": 42903.136673,
      "liquidationPrice": 0,
      "markPrice": 0.6724,
      "midPrice": 0.67263,
      "premiumPrice": -0.006097,
      "crossLeverage": 20,
      "isolatedLeverage": 0,
      "closeTime": null,
      "openTime": "2025-12-27T10:07:31.000Z",
      "liquidationProgress": 0,
      "profile": {
        "address": "0x31ca8395cf837de08b24da3f660e77761dfb974b",
        "totalEquity": 108804313.77896,
        "perpEquity": 108791713.384141,
        "countOpenPositions": 190,
        "pnl": 38084557.83896,
        "balance": 108791713.384141,
        "segments": [7, 8],
        "verified": false,
        "displayName": null,
        "emoji": null,
        "xUserId": null
      }
    }
  ]
}

---

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

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

Returns a 302 redirect to a download link for the Position Breakdown by Size. The downloaded file contains the Positions by Size for the selected coin. 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 Positions & Market Exposure 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-size' \
  --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",
  "createdAt": "2026-02-20T08:26:37.228Z",
  "breakdownBySize": [
    {
      "sizeSegmentId": 1,
      "size": "<$1k",
      "minSize": null,
      "maxSize": 1000,
      "positionCount": 180,
      "pastPositionCount": 183,
      "totalPositionValue": 29835.7012,
      "pastTotalPositionValue": 27732.44328,
      "totalPositionValueLong": 18949.09648,
      "valueCloseToLiquidation": 500.1304,
      "bias": 0.635
    }
  ]
}

---

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

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

Exports position metrics time-series data for the selected coin, including timestamped values for position count, long position count, total position value, and long position value. The columns array 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 Positions & Market Exposure 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-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",
  "metrics": {
    "columns": [
      "timestamp",
      "positionCount",
      "positionCountLong",
      "totalPositionValue",
      "totalPositionValueLong"
    ],
    "data": [
      [
        "2026-02-20T08:08:33.548Z",
        240,
        135,
        763871.15246,
        381935.57623
      ],
      [
        "2026-02-20T07:00:00.000Z",
        245,
        137,
        818896.40744,
        409448.20372
      ]
    ]
  }
}

---

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 Cohorts 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"
          ]
        ]
      }
    }
  ]
}

---

Get 5m Orders Snapshot (Download File)

/api/external/orders/5m-snapshots/{snapshotTime}/download

Returns a download link (URL) for the 5-minute orders snapshot file at the specified snapshotTime. Use this when you want to download the snapshot as a file instead of retrieving orders as JSON.

snapshotTime must follow these rules:

• Aligned to a 5-minute boundary

• >= 2026-01-19T11:05:00+00:00

• Not in the future

Currently on a 5-min granularity for all open orders. 1-min granularity coming soon!

Also found on the Order Data subpage here.

Query Parameters

Parameter	Type	Description
snapshotTime	string	Snapshot timestamp (path). Must be a multiple of 5 minutes, must be >= 2026-01-19T11:05:00+00:00and cannot be in the future.

Request Examples

Curl

curl --request GET \
  --url 'https://ht-api.coinmarketman.com/api/external/orders/5m-snapshots/2026-01-19T11:05:00+00:00/download'

JavaScript

Python

Response

200 Success: Returns a JSON object containing a downloadUrl for the requested snapshot.

Response Example

{
  "orders": [
    {
      "height": "123456789",
      "address": "0xabc123...",
      "oid": "987654321",
      "coin": "BTC",
      "side": "B",
      "limitPx": 43250.5,
      "sz": 0.25,
      "timestamp": "2026-03-09T09:28:27.394Z",
      "triggerCondition": "string",
      "isTrigger": false,
      "triggerPx": 43000,
      "children": {},
      "isPositionTpsl": false,
      "reduceOnly": true,
      "orderType": "limit",
      "origSz": 1.5,
      "tif": "string",
      "cloid": "client-123",
      "status": "open",
      "builder": "my-bot",
      "builderFee": 5,
      "untriggered": false
    }
  ],
  "nextCursor": "string"
}

---

Get Latest Orders Snapshot by Coin (Download Link)

/api/external/orders/5m-snapshots/coins/{coin}/download

Returns a download link (URL) for the latest 5-minute orders snapshot for a specific coin.

Currently on a 5-min granularity for all open orders. 1-min granularity coming soon!

Also found on the Order Data subpage here.

Query Parameters

Parameter	Type	Description
coin	string	Coin identifier to fetch the latest snapshot for (path parameter).

Request Examples

Curl

curl --request GET \
  --url 'https://ht-api.coinmarketman.com/api/external/orders/5m-snapshots/coins/btc/download'

JavaScript

Python

Response

200 Success: Returns a JSON object containing a downloadUrl.

Response Example

{
  "downloadUrl": "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 PERP PnL Leaderboard (Download Link)

/api/external/leaderboards/perp-pnl/{period}/download

Returns a temporary, pre-signed download link for exporting the perpetual PnL leaderboard for a selected period. The returned URL can be opened directly in a browser or fetched programmatically to download the export file. The link expires automatically after a short time.

Also found on the Leaderboards subpage here.

Query Parameters

Parameter	Type	Description
period	string	Leaderboard period to export. Allowed values: day, week, month, all.

Request Examples

Curl

curl --request GET \
  --url 'https://ht-api.coinmarketman.com/api/external/leaderboards/perp-pnl/all/download' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'

Python

Response

200 Success: Returns a temporary download URL.

Response Example

{
  "downloadUrl": "string"
}