# Stats Page Data

Endpoints powering the [Stats page](https://app.coinmarketman.com/hypertracker/stats) on the HyperTracker dashboard.\
\
Use these APIs to reconstruct core market metrics, including open interest, volume, trader activity, and position-level aggregates.

***

### Get Total Wallet Equity Stats (Download File)

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

<figure><img src="/spaces/Kkv2IiibnImsf0K43fna/files/D7t6fuZQ61nO71rW3Knd" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="success" %}
**Unique to HyperTracker Users**
{% endhint %}

*Returns a 302 redirect to a short-lived download link so you can fetch an export file directly from S3. The export includes wallet equity chart data with the all-time-high breakdown, the same breakdown from 24 hours earlier, and historical values over time across total, perp, spot, staking, and vault equity. 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.*

*This is the same data found on the HyperTracker* [*Stats*](https://app.coinmarketman.com/hypertracker/stats) *page*

Request Examples

{% tabs %}
{% tab title="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
```

{% endtab %}

{% tab title="Python" %}

```
import requests

response = requests.get(
    'https://ht-api.coinmarketman.com/api/external/exports/total-wallets-equity-chart-data',
    headers={'Authorization': 'Bearer YOUR_API_TOKEN'},
    allow_redirects=True
)

export_data = response.json()
```

{% endtab %}
{% endtabs %}

Response

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

<details>

<summary>Response Example</summary>

{% code expandable="true" %}

```
{
    "athData": {
        "columns": [
            "totalWalletsEquity",
            "perpWalletsEquity",
            "spotWalletsEquity",
            "stakingWalletsEquity",
            "vaultWalletsEquity"
        ],
        "data": [
            39121706646.26555,
            5797951380.888283,
            6462250711.142883,
            26054212736.934635,
            1082356296.156288
        ]
    },
    "data24HoursAgo": {
        "columns": [
            "totalWalletsEquity",
            "perpWalletsEquity",
            "spotWalletsEquity",
            "stakingWalletsEquity",
            "vaultWalletsEquity"
        ],
        "data": [
            24451021836.249054,
            3960404867.883486,
            3250561919.527497,
            16421420397.269457,
            818634651.568614
        ]
    },
    "history": {
        "columns": [
            "timestamp",
            "totalWalletsEquity",
            "perpWalletsEquity",
            "spotWalletsEquity",
            "stakingWalletsEquity",
            "vaultWalletsEquity"
        ],
        "data": [
            ["2025-08-20T17:13:56.403Z", 28902441744.20177, 4327165186.01241, 6144076058.910398, 18431200499.27896, null],
            ["2025-08-22T21:27:45.111Z", 29661321100.68525, 4930975201.850779, 5168711721.906799, 19561634176.92767, null],
            ["2025-08-25T01:26:39.143Z", 30512735834.459076, 5047323607.572472, 5364743638.77878, 20100668588.107822, null],
            ["2025-08-27T05:37:50.411Z", 32980711094.305115, 4938451913.479016, 5757908484.675566, 22284350696.150536, null],
            ["2025-08-30T03:09:24.489Z", 29642685112.329956, 5005079647.158699, 5210090224.776111, 19427515240.395145, null],
            ["2025-09-01T07:07:17.903Z", 29700141632.917686, 5018742725.07734, 5278125423.69934, 19403273484.141006, null],
            ["2025-09-02T00:33:53.243Z", 29123959822.190533, 5053260129.614452, 5075666663.43577, 18995033029.14031, 0],
            ["2025-09-04T04:42:41.372Z", 31661172841.647095, 5351562875.482222, 5264106649.131976, 19964310318.16552, 1081192998.867375],
            ["2025-09-06T08:21:55.367Z", 32302227050.041267, 5332929990.339022, 5301162589.080947, 20604303148.540436, 1063831322.080864],
            ["2025-09-08T12:53:58.891Z", 34438933670.139656, 5305995606.308671, 5630250482.497716, 22448587740.784348, 1054099840.548921],
            ["2025-09-10T16:52:30.067Z", 36720964893.25762, 5435180125.826538, 5950267336.560196, 24328411137.267178, 1007106293.603713],
            ["2025-09-12T03:40:36.607Z", 37645830979.21101, 5538731612.753904, 6000805486.105284, 25089749745.560192, 1016544134.791636],
            ["2025-09-14T07:48:44.055Z", 36719128911.24629, 5694712048.125544, 5900329515.154258, 24141848951.716675, 982238396.249818],
            ["2025-09-17T22:41:24.107Z", 38056950553.125305, 5653402845.628025, 6304014088.047718, 25171410653.099686, 928122966.349874],
            ["2025-09-20T02:45:05.294Z", 37111079771.45436, 5681016274.992708, 5956014074.763371, 24550280813.11323, 923768608.585049],
            ["2025-09-23T00:09:07.303Z", 32241993032.368755, 5607009278.631537, 5119338562.140575, 20633104047.784748, 882541143.811896],
            ["2025-09-26T12:31:12.167Z", 28897655417.127216, 5360569245.091494, 4846465084.562279, 17876415608.83209, 814205478.641355],
            ["2025-09-29T12:28:25.608Z", 31692871868.178764, 5281506805.680196, 5462981912.580055, 20140092485.455986, 808290664.462528],
            ["2025-10-02T09:51:17.397Z", 33122441364.183743, 5294020388.909638, 5664458920.131001, 21338293219.4512, 825668835.691905],
            ["2025-10-05T07:19:38.119Z", 33868455003.77326, 5473714264.298804, 5791841440.110322, 21788978679.534195, 813920619.829938],
            ["2025-10-08T22:11:50.031Z", 31473325473.85279, 5460707845.674725, 5365344845.706621, 19893560440.876434, 753712341.595013],
            ["2025-10-11T02:19:13.447Z", 25763072059.306934, 4773056984.313144, 4286966588.923622, 15929750310.489595, 773298175.580575],
            ["2025-10-13T23:52:30.493Z", 28845854478.20219, 4620956313.285926, 4756246359.051054, 18531147973.184574, 937503832.680634],
            ["2025-10-17T14:40:18.592Z", 24506017459.180767, 4391279986.408135, 4037715965.561753, 15040806982.65625, 1036214524.55463],
            ["2025-10-20T12:04:23.946Z", 26109914524.104317, 4365812568.287291, 4409019966.844085, 16309264846.006256, 1025817142.966684],
            ["2025-10-24T02:44:21.404Z", 26819993227.701897, 4338481832.58275, 4670262013.38419, 16777882821.417427, 1033366560.317528],
            ["2025-10-27T00:22:55.862Z", 30732956307.49371, 4463638523.859688, 5232470971.93194, 20004813262.178432, 1032033549.523648],
            ["2025-10-30T15:10:43.843Z", 30231330711.369095, 4531638923.550747, 5016325758.654478, 19647350450.59443, 1036015578.569441],
            ["2025-11-02T12:27:07.548Z", 28149382023.861732, 4478269210.520305, 4688785972.453062, 17955197081.36343, 1027129759.524935],
            ["2025-11-05T09:29:52.904Z", 26479528792.984554, 4342638961.933719, 4330450250.684296, 16793345828.625935, 1013093751.740607],
            ["2025-11-08T07:33:11.421Z", 27042372904.4052, 4422568792.533792, 4402559138.853572, 17193998798.237694, 1023246174.780145],
            ["2025-11-11T22:23:20.108Z", 25644868958.302734, 4377450926.90436, 4092634841.260039, 16174156535.783579, 1000626654.354759],
            ["2025-11-15T13:17:45.638Z", 25259868795.126488, 4221062015.895892, 3432512348.016513, 16657857489.451015, 948436941.763067],
            ["2025-11-18T10:44:15.885Z", 26150592661.203247, 4173973677.490453, 3567157643.840946, 17519530236.5523, 889931103.319548],
            ["2025-11-22T01:41:55.684Z", 22352192054.811214, 3924059389.180077, 3095072564.544759, 14494245360.04895, 838814741.037427],
            ["2025-11-25T16:30:24.705Z", 21455517018.14413, 3889624355.443965, 3030051653.469181, 13708052274.188524, 827788735.04246],
            ["2025-11-29T07:20:01.437Z", 22704837725.994087, 3936318817.647988, 3274763552.513015, 14665912323.698483, 827843032.134601],
            ["2025-12-02T22:13:39.389Z", 21590606573.558125, 3858342022.889067, 3112052186.403538, 13862849482.68207, 757362881.58345],
            ["2025-12-06T13:01:48.718Z", 7709182155.474927, 3863906881.947697, 2903405025.83327, 182577560.154219, 759292687.539741],
            ["2025-12-10T03:42:58.632Z", 7744827847.539869, 4012316688.719229, 2817295837.383812, 155922633.897087, 759292687.539741],
            ["2025-12-13T01:15:09.314Z", 20313119289.69756, 4171803419.462202, 2841925503.459227, 12550884761.18648, 748505605.589652],
            ["2025-12-18T02:53:22.133Z", 17877837211.054924, 3985860533.173206, 2530431405.846078, 10656927023.823938, 704618248.211701],
            ["2025-12-22T11:00:35.517Z", 18304699808.835144, 4011645687.378118, 2502186940.507333, 11099499458.282423, 691367722.667269],
            ["2025-12-27T12:42:05.361Z", 18599355891.781868, 4029191338.440766, 2522730671.841575, 11370131364.924599, 677302516.574927],
            ["2025-12-31T03:22:13.193Z", 18447903702.508053, 4041825087.45796, 2471498065.597977, 11294997985.13486, 639582564.317254],
            ["2026-01-03T18:19:07.661Z", 17976632964.047176, 4054482099.279025, 2442065764.667057, 10859292241.571798, 620792858.529297],
            ["2026-01-07T08:57:02.575Z", 19603952966.712738, 4275852198.26447, 2705849442.172735, 12023907286.896694, 598344039.378838],
            ["2026-01-11T17:22:10.628Z", 17854433886.52695, 4142133329.64751, 2428845907.397932, 10748921682.271873, 534532967.209635],
            ["2026-01-15T07:53:12.474Z", 18188508045.626366, 4288201629.134548, 2450582884.755761, 10917847777.910046, 531875753.826013],
            ["2026-01-20T09:37:14.633Z", 17084674956.202166, 4186471749.728371, 2289875696.810711, 10079579323.83932, 528748185.823764],
            ["2026-01-24T17:51:00.903Z", 16964187085.507437, 4037699883.571744, 2300886059.857274, 10096868338.55849, 528732803.519928],
            ["2026-01-28T08:41:14.726Z", 22337664461.834267, 4146219322.193873, 2972451614.669233, 14688366222.846865, 530627302.124295],
            ["2026-02-01T17:00:32.235Z", 20046767249.291325, 3971284361.759455, 2646287705.190282, 12875318908.462141, 553876273.879446],
            ["2026-02-05T07:43:29.676Z", 22585732137.467796, 3848362729.820231, 2949774613.434402, 15197452204.91975, 590142589.293414],
            ["2026-02-09T15:52:47.924Z", 21116164806.76462, 3628440413.13142, 2813807108.722769, 14002410763.871876, 671506521.038556],
            ["2026-02-13T06:42:56.980Z", 20657197778.827072, 3650560542.73063, 2785563495.690928, 13541328041.245098, 679745699.160418],
            ["2026-02-17T14:55:45.420Z", 19894775620.772114, 3634362078.681048, 2689826798.84688, 12872023195.718988, 698563547.525196],
            ["2026-02-21T23:14:48.956Z", 20067495630.75934, 3666663831.037835, 2710586884.316602, 12989408766.754227, 700836148.650674],
            ["2026-02-25T14:09:08.667Z", 19071855705.769653, 3641931924.887696, 2590582966.854337, 12132067527.05426, 707273286.97336],
            ["2026-03-01T04:51:44.300Z", 20666570968.922085, 3671176076.485631, 2822292417.296528, 13473577760.315699, 699524714.824229],
            ["2026-03-04T19:48:58.433Z", 21713010682.586033, 3774615133.833198, 2956448804.124789, 14209522031.619242, 772424713.008803],
            ["2026-03-09T21:18:33.436Z", 22802140025.341835, 3766161490.851886, 3058641224.588019, 15205383075.058958, 771954234.842972],
            ["2026-03-13T12:09:58.925Z", 24224602966.361534, 3864226469.372407, 3229302670.328028, 16357625832.694378, 773447993.966721],
            ["2026-03-17T20:26:09.656Z", 26124503655.52107, 3917921021.614015, 3464857163.76797, 17960592381.534657, 781133088.604428],
            ["2026-03-20T17:41:41.184Z", 25285979972.91727, 3995371988.41787, 3282245980.425102, 17182528614.97663, 825833389.097666],
            ["2026-03-24T08:49:39.698Z", 24866251510.56135, 3987147407.699973, 3295157887.759215, 16766222726.909422, 817723488.192741]
        ]
    }
}
```

{% endcode %}

</details>

***

### Get Count Open Positions, Open Interest, OI vs Perp Equity, Positions in Profit

`/api/external/position-metrics/general`

<figure><img src="/files/mNN7t8UrEHow7XNR2KXv" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="success" %}
**Unique to HyperTracker Users**
{% endhint %}

*Returns a time-series of market-wide snapshots powering the Open Interest, Total Open Positions, Open Interest vs Perp Equity, and Positions In Profit charts. Each snapshot includes total open interest with long and short split, total position count with long and short breakdown, total perp equity, and the number of positions currently in profit. Results are paginated using `nextCursor`.*

<details>

<summary>Query Parameters</summary>

| Parameter    | Type     | Description                                                                                          |
| ------------ | -------- | ---------------------------------------------------------------------------------------------------- |
| `limit`      | `string` | Maximum number of metric snapshots 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”.                              |

</details>

Request Examples

{% tabs %}
{% tab title="Curl" %}

```
curl --request GET \
  --url 'https://ht-api.coinmarketman.com/api/external/position-metrics/general?limit=100&start=2026-02-10T12%3A28%3A24.772Z&end=2026-02-11T12%3A28%3A24.772Z' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'
```

{% endtab %}

{% tab title="Python" %}

```
import requests

response = requests.get(
    'https://ht-api.coinmarketman.com/api/external/position-metrics/general',
    params={
        'limit': 100,
        'start': '2026-02-10T12:28:24.772Z',
        'end': '2026-02-11T12:28:24.772Z'
    },
    headers={'Authorization': 'Bearer YOUR_API_TOKEN'}
)

metrics = response.json()
```

{% endtab %}
{% endtabs %}

Response

> 200 Success: Returns a list of general position metric snapshots for the requested time window, plus an optional cursor for pagination.

<details>

<summary>Response Example</summary>

{% code expandable="true" %}

```
{
    "metrics": [
        {
            "id": 161297,
            "createdAt": "2026-01-26T10:40:00.055Z",
            "count": 209394,
            "countLong": 105465,
            "countShort": 103929,
            "openInterest": 8151285532.311602,
            "openInterestLong": 4075642766.155801,
            "openInterestShort": 4075642766.155801,
            "perpEquity": 3218636288.609066,
            "countInProfit": 118681
        },
        {
            "id": 161099,
            "createdAt": "2026-01-26T09:40:00.087Z",
            "count": 209069,
            "countLong": 105460,
            "countShort": 103609,
            "openInterest": 8229120530.604678,
            "openInterestLong": 4114560265.302339,
            "openInterestShort": 4114560265.302339,
            "perpEquity": 3216688885.20458,
            "countInProfit": 119958
        },
        {
            "id": 160934,
            "createdAt": "2026-01-26T08:50:00.071Z",
            "count": 209011,
            "countLong": 106195,
            "countShort": 102816,
            "openInterest": 8240524741.921798,
            "openInterestLong": 4120262370.960899,
            "openInterestShort": 4120262370.960899,
            "perpEquity": 3219173309.65958,
            "countInProfit": 119208
        },
        {
            "id": 160769,
            "createdAt": "2026-01-26T07:50:00.163Z",
            "count": 208692,
            "countLong": 105958,
            "countShort": 102734,
            "openInterest": 8213249162.162434,
            "openInterestLong": 4106624581.081217,
            "openInterestShort": 4106624581.081217,
            "perpEquity": 3210675918.318907,
            "countInProfit": 118575
        },
        {
            "id": 160637,
            "createdAt": "2026-01-26T07:00:00.084Z",
            "count": 208485,
            "countLong": 105720,
            "countShort": 102765,
            "openInterest": 8164090513.625564,
            "openInterestLong": 4082045256.812782,
            "openInterestShort": 4082045256.812782,
            "perpEquity": 3212916027.511405,
            "countInProfit": 118135
        },
        {
            "id": 160406,
            "createdAt": "2026-01-26T05:40:00.334Z",
            "count": 208165,
            "countLong": 105674,
            "countShort": 102491,
            "openInterest": 8149269977.36604,
            "openInterestLong": 4074634988.68302,
            "openInterestShort": 4074634988.68302,
            "perpEquity": 3210330495.775964,
            "countInProfit": 118127
        },
        {
            "id": 160175,
            "createdAt": "2026-01-26T04:30:00.083Z",
            "count": 208149,
            "countLong": 105745,
            "countShort": 102404,
            "openInterest": 8074892486.010412,
            "openInterestLong": 4037446243.005206,
            "openInterestShort": 4037446243.005206,
            "perpEquity": 3210485724.474447,
            "countInProfit": 117294
        },
        {
            "id": 159944,
            "createdAt": "2026-01-26T03:10:00.072Z",
            "count": 207924,
            "countLong": 105505,
            "countShort": 102419,
            "openInterest": 8167601830.175086,
            "openInterestLong": 4083800915.087543,
            "openInterestShort": 4083800915.087543,
            "perpEquity": 3216325945.49065,
            "countInProfit": 118938
        },
        {
            "id": 159713,
            "createdAt": "2026-01-26T01:50:00.156Z",
            "count": 208684,
            "countLong": 105637,
            "countShort": 103047,
            "openInterest": 8232762855.139466,
            "openInterestLong": 4116381427.569733,
            "openInterestShort": 4116381427.569733,
            "perpEquity": 3222739346.538861,
            "countInProfit": 118216
        },
        {
            "id": 159482,
            "createdAt": "2026-01-26T00:40:00.115Z",
            "count": 208457,
            "countLong": 105192,
            "countShort": 103265,
            "openInterest": 8175094589.776354,
            "openInterestLong": 4087547294.888177,
            "openInterestShort": 4087547294.888177,
            "perpEquity": 3225194216.726351,
            "countInProfit": 115564
        },
        {
            "id": 159284,
            "createdAt": "2026-01-25T23:30:00.041Z",
            "count": 209033,
            "countLong": 105365,
            "countShort": 103668,
            "openInterest": 8111039327.314746,
            "openInterestLong": 4055519663.657373,
            "openInterestShort": 4055519663.657373,
            "perpEquity": 3225078957.230942,
            "countInProfit": 115216
        },
        {
            "id": 159053,
            "createdAt": "2026-01-25T22:20:00.086Z",
            "count": 208625,
            "countLong": 105130,
            "countShort": 103495,
            "openInterest": 8105435014.093428,
            "openInterestLong": 4052717507.046714,
            "openInterestShort": 4052717507.046714,
            "perpEquity": 3229569020.653146,
            "countInProfit": 115906
        },
        {
            "id": 158921,
            "createdAt": "2026-01-25T21:40:00.060Z",
            "count": 208224,
            "countLong": 104348,
            "countShort": 103876,
            "openInterest": 8105255222.126508,
            "openInterestLong": 4052627611.063254,
            "openInterestShort": 4052627611.063254,
            "perpEquity": 3233540905.304803,
            "countInProfit": 115275
        },
        {
            "id": 158591,
            "createdAt": "2026-01-25T20:00:00.034Z",
            "count": 209744,
            "countLong": 105509,
            "countShort": 104235,
            "openInterest": 8099586768.57674,
            "openInterestLong": 4049793384.28837,
            "openInterestShort": 4049793384.28837,
            "perpEquity": 3221728400.64528,
            "countInProfit": 114485
        },
        {
            "id": 158393,
            "createdAt": "2026-01-25T18:50:00.044Z",
            "count": 211303,
            "countLong": 106871,
            "countShort": 104432,
            "openInterest": 8114965494.235754,
            "openInterestLong": 4057482747.117877,
            "openInterestShort": 4057482747.117877,
            "perpEquity": 3202373638.693533,
            "countInProfit": 116166
        },
        {
            "id": 158063,
            "createdAt": "2026-01-25T17:00:00.207Z",
            "count": 211759,
            "countLong": 106979,
            "countShort": 104780,
            "openInterest": 7976395063.880228,
            "openInterestLong": 3988197531.940114,
            "openInterestShort": 3988197531.940114,
            "perpEquity": 3200856222.06015,
            "countInProfit": 116278
        },
        {
            "id": 157700,
            "createdAt": "2026-01-25T15:00:00.041Z",
            "count": 213908,
            "countLong": 109126,
            "countShort": 104782,
            "openInterest": 8166038107.627766,
            "openInterestLong": 4083019053.813883,
            "openInterestShort": 4083019053.813883,
            "perpEquity": 3209337523.972243,
            "countInProfit": 116475
        },
        {
            "id": 157106,
            "createdAt": "2026-01-25T12:00:00.049Z",
            "count": 213152,
            "countLong": 108708,
            "countShort": 104444,
            "openInterest": 8210656424.653996,
            "openInterestLong": 4105328212.326998,
            "openInterestShort": 4105328212.326998,
            "perpEquity": 3214046441.072649,
            "countInProfit": 114165
        },
        {
            "id": 156545,
            "createdAt": "2026-01-25T09:00:00.166Z",
            "count": 213595,
            "countLong": 110849,
            "countShort": 102746,
            "openInterest": 8282668101.965074,
            "openInterestLong": 4141334050.982537,
            "openInterestShort": 4141334050.982537,
            "perpEquity": 3222216678.955741,
            "countInProfit": 114720
        },
        {
            "id": 156215,
            "createdAt": "2026-01-25T07:00:00.055Z",
            "count": 213559,
            "countLong": 110970,
            "countShort": 102589,
            "openInterest": 8225195282.61186,
            "openInterestLong": 4112597641.30593,
            "openInterestShort": 4112597641.30593,
            "perpEquity": 3216258117.750576,
            "countInProfit": 114573
        },
        {
            "id": 155027,
            "createdAt": "2026-01-25T00:00:00.046Z",
            "count": 213485,
            "countLong": 111043,
            "countShort": 102442,
            "openInterest": 8277813529.162244,
            "openInterestLong": 4138906764.581122,
            "openInterestShort": 4138906764.581122,
            "perpEquity": 3216632750.535978,
            "countInProfit": 113693
        }
    ],
    "nextCursor": "BEARER_KEY"
}
```

{% endcode %}

</details>

***

### Get Perp Volume History

`/api/external/metrics/perp-volume`

<figure><img src="/files/WXjzILcM5mqrKyhc8956" alt="" width="375"><figcaption></figcaption></figure>

Returns historical perp trading volume snapshots used to build the Daily Volume chart on the HyperTracker Stats page.

<details>

<summary>Query Parameters</summary>

| Parameter    | Type     | Description                                                                                          |
| ------------ | -------- | ---------------------------------------------------------------------------------------------------- |
| `limit`      | `number` | Maximum number of metric snapshots to return per request.                                            |
| `nextCursor` | `string` | Cursor for pagination. Use the `nextCursor` value from the previous response to fetch the next page. |
| `start`      | `string` | **Required.** Start of the time window (ISO 8601, UTC).                                              |
| `end`        | `string` | End of the time window (ISO 8601, UTC). If omitted, the API uses “now”.                              |

</details>

Request Examples

{% tabs %}
{% tab title="Curl" %}

```
curl --request GET \
  --url 'https://ht-api.coinmarketman.com/api/external/metrics/perp-volume?start=2026-02-10T10:47:49.887Z&end=2026-02-10T10:47:49.888Z&limit=1' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'
```

{% endtab %}

{% tab title="JavaScript" %}

```
const url = new URL("https://ht-api.coinmarketman.com/api/external/metrics/perp-volume");
url.searchParams.set("start", "2026-02-10T10:47:49.887Z");
url.searchParams.set("end", "2026-02-10T10:47:49.888Z");
url.searchParams.set("limit", "1");
// url.searchParams.set("nextCursor", "YOUR_CURSOR"); // optional

const res = await fetch(url.toString(), {
  method: "GET",
  headers: {
    Authorization: "Bearer YOUR_API_TOKEN",
  },
});

const data = await res.json();
console.log(data);

```

{% endtab %}

{% tab title="Python" %}

```
import requests

response = requests.get(
    "https://ht-api.coinmarketman.com/api/external/metrics/perp-volume",
    params={"start": "2026-02-01", "end": "2026-02-13"},
    headers={
        "Authorization": "Bearer YOUR_API_TOKEN",
    },
)

result = response.json()
```

{% endtab %}
{% endtabs %}

Response

> **200 Success:** Returns perp volume snapshots ordered by timestamp, with pagination via `nextCursor`.

<details>

<summary>Response Example</summary>

{% code expandable="true" %}

```
{
    "metrics": [
        { "id": 36769, "createdAt": "2025-12-19T17:58:00.667Z", "volume": 8264467647.707415 },
        { "id": 36637, "createdAt": "2025-12-19T13:58:00.779Z", "volume": 8920955224.727062 },
        { "id": 36373, "createdAt": "2025-12-19T05:58:00.660Z", "volume": 8984696094.182817 },
        { "id": 36109, "createdAt": "2025-12-18T21:58:00.688Z", "volume": 8271395854.47119 },
        { "id": 35845, "createdAt": "2025-12-18T13:58:00.825Z", "volume": 8352231584.604436 },
        { "id": 35581, "createdAt": "2025-12-18T05:58:00.777Z", "volume": 7620996802.412385 },
        { "id": 35317, "createdAt": "2025-12-17T21:58:00.801Z", "volume": 7583214513.079753 },
        { "id": 35086, "createdAt": "2025-12-17T13:58:00.700Z", "volume": 4209508918.8583717 },
        { "id": 34822, "createdAt": "2025-12-17T05:58:00.774Z", "volume": 4884379531.277506 },
        { "id": 34558, "createdAt": "2025-12-16T21:58:00.814Z", "volume": 5316896541.6887455 },
        { "id": 34294, "createdAt": "2025-12-16T13:58:00.798Z", "volume": 7871582901.082105 },
        { "id": 34030, "createdAt": "2025-12-16T05:58:00.759Z", "volume": 7186409110.592694 },
        { "id": 33766, "createdAt": "2025-12-15T21:58:00.773Z", "volume": 7781344246.456123 },
        { "id": 33502, "createdAt": "2025-12-15T13:58:00.680Z", "volume": 4355383529.618316 },
        { "id": 33238, "createdAt": "2025-12-15T05:58:00.757Z", "volume": 4423672678.956782 },
        { "id": 32974, "createdAt": "2025-12-14T21:58:01.260Z", "volume": 2626327863.281712 },
        { "id": 32710, "createdAt": "2025-12-14T13:58:00.713Z", "volume": 1959362166.232217 },
        { "id": 32446, "createdAt": "2025-12-14T05:58:00.795Z", "volume": 1506791329.357013 },
        { "id": 32182, "createdAt": "2025-12-13T21:58:00.709Z", "volume": 1466983496.4121687 },
        { "id": 31984, "createdAt": "2025-12-13T15:58:00.682Z", "volume": 3172068398.089385 },
        { "id": 31720, "createdAt": "2025-12-13T07:58:00.827Z", "volume": 4767516496.669213 },
        { "id": 31456, "createdAt": "2025-12-12T23:58:00.687Z", "volume": 5893824860.891351 },
        { "id": 31258, "createdAt": "2025-12-12T17:58:00.672Z", "volume": 7927215767.599981 },
        { "id": 31060, "createdAt": "2025-12-12T11:58:00.731Z", "volume": 6807402763.890092 },
        { "id": 30862, "createdAt": "2025-12-12T05:58:00.679Z", "volume": 6555661232.563197 },
        { "id": 30664, "createdAt": "2025-12-11T23:58:00.670Z", "volume": 7712083774.2577715 },
        { "id": 30466, "createdAt": "2025-12-11T17:58:00.672Z", "volume": 9377234795.938663 },
        { "id": 30268, "createdAt": "2025-12-11T11:58:00.816Z", "volume": 8860085468.648182 },
        { "id": 30070, "createdAt": "2025-12-11T05:58:00.750Z", "volume": 9108207161.967392 },
        { "id": 29872, "createdAt": "2025-12-10T23:58:00.722Z", "volume": 7962372547.974165 },
        { "id": 29608, "createdAt": "2025-12-10T15:58:00.677Z", "volume": 7149497288.072199 },
        { "id": 29344, "createdAt": "2025-12-10T07:58:00.781Z", "volume": 8282122826.26998 },
        { "id": 29080, "createdAt": "2025-12-09T23:58:00.656Z", "volume": 8390006988.892338 },
        { "id": 28816, "createdAt": "2025-12-09T15:58:00.753Z", "volume": 6192955769.614952 },
        { "id": 28552, "createdAt": "2025-12-09T07:58:00.693Z", "volume": 6010639262.949638 },
        { "id": 28288, "createdAt": "2025-12-08T23:58:00.683Z", "volume": 6028269314.092666 },
        { "id": 28024, "createdAt": "2025-12-08T15:58:00.735Z", "volume": 7257518511.908028 },
        { "id": 27760, "createdAt": "2025-12-08T07:58:00.760Z", "volume": 6943953120.979986 },
        { "id": 27496, "createdAt": "2025-12-07T23:58:00.733Z", "volume": 6048030697.14782 },
        { "id": 27232, "createdAt": "2025-12-07T15:58:00.809Z", "volume": 3614460580.554322 },
        { "id": 26968, "createdAt": "2025-12-07T07:58:00.731Z", "volume": 2310286597.265669 },
        { "id": 26704, "createdAt": "2025-12-06T23:58:00.965Z", "volume": 2329323316.343656 },
        { "id": 26440, "createdAt": "2025-12-06T15:58:00.363Z", "volume": 4786518863.267189 },
        { "id": 26176, "createdAt": "2025-12-06T07:58:00.683Z", "volume": 6588660620.77583 },
        { "id": 25912, "createdAt": "2025-12-05T23:58:00.665Z", "volume": 7061301782.690229 },
        { "id": 25648, "createdAt": "2025-12-05T15:58:00.858Z", "volume": 5865022607.182083 },
        { "id": 25384, "createdAt": "2025-12-05T07:03:16.926Z", "volume": 5037825508.897606 },
        { "id": 25120, "createdAt": "2025-12-04T23:03:39.457Z", "volume": 5971877665.224266 },
        { "id": 24856, "createdAt": "2025-12-04T15:05:54.813Z", "volume": 5585420482.439113 },
        { "id": 24592, "createdAt": "2025-12-04T07:04:08.545Z", "volume": 6691251003.222111 },
        { "id": 24328, "createdAt": "2025-12-03T23:04:45.292Z", "volume": 6872213823.85546 },
        { "id": 24064, "createdAt": "2025-12-03T15:07:50.168Z", "volume": 8473206617.720651 },
        { "id": 23800, "createdAt": "2025-12-03T07:04:18.896Z", "volume": 8424534282.841121 },
        { "id": 23536, "createdAt": "2025-12-02T23:03:06.285Z", "volume": 7596302346.840353 },
        { "id": 23272, "createdAt": "2025-12-02T15:07:14.351Z", "volume": 7127940885.563953 },
        { "id": 23008, "createdAt": "2025-12-02T07:03:56.504Z", "volume": 7284128118.49519 },
        { "id": 22777, "createdAt": "2025-12-01T23:58:00.746Z", "volume": 10016093639.617512 },
        { "id": 22513, "createdAt": "2025-12-01T15:58:01.284Z", "volume": 8177150707.967087 },
        { "id": 22249, "createdAt": "2025-12-01T07:58:00.804Z", "volume": 5978546407.303156 },
        { "id": 22018, "createdAt": "2025-12-01T01:09:16.313Z", "volume": 4401464925.897029 },
        { "id": 21985, "createdAt": "2025-11-30T23:58:00.840Z", "volume": 2611132438.5170674 },
        { "id": 21721, "createdAt": "2025-11-30T15:58:00.322Z", "volume": 2576304973.3169527 },
        { "id": 21457, "createdAt": "2025-11-30T07:58:00.947Z", "volume": 2412350949.2536297 },
        { "id": 21193, "createdAt": "2025-11-29T23:58:00.689Z", "volume": 2749208370.296919 },
        { "id": 20929, "createdAt": "2025-11-29T15:58:00.861Z", "volume": 3649337932.669519 },
        { "id": 20665, "createdAt": "2025-11-29T07:58:00.622Z", "volume": 5003349124.892507 },
        { "id": 20401, "createdAt": "2025-11-28T23:58:00.767Z", "volume": 5250145666.415256 },
        { "id": 20137, "createdAt": "2025-11-28T15:58:00.699Z", "volume": 4616533743.412037 },
        { "id": 19873, "createdAt": "2025-11-28T07:58:00.703Z", "volume": 3927180337.8827353 },
        { "id": 19609, "createdAt": "2025-11-27T23:58:00.833Z", "volume": 4539062959.293477 },
        { "id": 19345, "createdAt": "2025-11-27T15:58:00.724Z", "volume": 6551719675.664135 },
        { "id": 19081, "createdAt": "2025-11-27T07:58:00.708Z", "volume": 6879053286.834448 },
        { "id": 18817, "createdAt": "2025-11-26T23:58:00.764Z", "volume": 6816598283.578085 },
        { "id": 18553, "createdAt": "2025-11-26T15:58:00.892Z", "volume": 7009182974.155796 },
        { "id": 18289, "createdAt": "2025-11-26T07:58:00.860Z", "volume": 7773877440.192795 },
        { "id": 18025, "createdAt": "2025-11-25T23:58:00.729Z", "volume": 7519553160.048481 },
        { "id": 17761, "createdAt": "2025-11-25T15:58:00.922Z", "volume": 7905605803.417404 },
        { "id": 17497, "createdAt": "2025-11-25T07:58:00.876Z", "volume": 8034049049.538204 },
        { "id": 17233, "createdAt": "2025-11-24T23:58:00.668Z", "volume": 9385152431.931217 },
        { "id": 16969, "createdAt": "2025-11-24T15:58:00.908Z", "volume": 8030882068.040141 },
        { "id": 16705, "createdAt": "2025-11-24T07:58:00.665Z", "volume": 6826209093.995252 },
        { "id": 16441, "createdAt": "2025-11-23T23:58:00.719Z", "volume": 6217323809.580251 },
        { "id": 16177, "createdAt": "2025-11-23T15:58:00.876Z", "volume": 5144606762.255274 },
        { "id": 15913, "createdAt": "2025-11-23T07:58:00.831Z", "volume": 5180406790.863818 },
        { "id": 15649, "createdAt": "2025-11-22T23:58:00.527Z", "volume": 4556151421.84132 },
        { "id": 15385, "createdAt": "2025-11-22T15:58:00.523Z", "volume": 7681935302.104391 },
        { "id": 15187, "createdAt": "2025-11-22T09:58:00.759Z", "volume": 11701366233.7982 },
        { "id": 15022, "createdAt": "2025-11-22T05:04:20.119Z", "volume": 14593707190.923714 },
        { "id": 14857, "createdAt": "2025-11-21T23:58:00.754Z", "volume": 15542008339.623411 },
        { "id": 14692, "createdAt": "2025-11-21T19:05:27.364Z", "volume": 15690966043.102322 },
        { "id": 14593, "createdAt": "2025-11-21T15:58:00.704Z", "volume": 17292864003.872692 },
        { "id": 14461, "createdAt": "2025-11-21T11:58:00.543Z", "volume": 14976552153.69328 },
        { "id": 14296, "createdAt": "2025-11-21T07:05:52.345Z", "volume": 11399547399.62816 },
        { "id": 14131, "createdAt": "2025-11-21T01:58:00.781Z", "volume": 10533029982.384779 },
        { "id": 13933, "createdAt": "2025-11-20T19:58:00.737Z", "volume": 11126416441.716465 },
        { "id": 13735, "createdAt": "2025-11-20T13:58:00.698Z", "volume": 9024176516.78238 },
        { "id": 13537, "createdAt": "2025-11-20T07:58:00.719Z", "volume": 9093644205.992664 },
        { "id": 13339, "createdAt": "2025-11-20T01:58:00.280Z", "volume": 9696065035.311974 },
        { "id": 13141, "createdAt": "2025-11-19T19:58:00.931Z", "volume": 8001827886.41088 },
        { "id": 12943, "createdAt": "2025-11-19T13:58:00.713Z", "volume": 7565430136.637927 },
        { "id": 12745, "createdAt": "2025-11-19T07:58:00.497Z", "volume": 8023986284.912955 },
        { "id": 12547, "createdAt": "2025-11-19T01:58:00.759Z", "volume": 9525825753.148766 },
        { "id": 12349, "createdAt": "2025-11-18T19:58:00.945Z", "volume": 10715203340.253527 },
        { "id": 12151, "createdAt": "2025-11-18T13:58:00.726Z", "volume": 12411928791.387383 },
        { "id": 11953, "createdAt": "2025-11-18T07:58:00.664Z", "volume": 12180031387.959759 },
        { "id": 11755, "createdAt": "2025-11-18T01:58:00.697Z", "volume": 9658868481.853127 },
        { "id": 11557, "createdAt": "2025-11-17T19:58:00.547Z", "volume": 9390773666.528643 },
        { "id": 11359, "createdAt": "2025-11-17T13:58:00.821Z", "volume": 7207651489.436318 },
        { "id": 11161, "createdAt": "2025-11-17T07:58:00.778Z", "volume": 7287426036.368677 },
        { "id": 10963, "createdAt": "2025-11-17T01:58:00.788Z", "volume": 7174076601.001867 },
        { "id": 10765, "createdAt": "2025-11-16T19:58:00.675Z", "volume": 6217605874.432446 },
        { "id": 10567, "createdAt": "2025-11-16T13:58:00.743Z", "volume": 4631942162.220092 },
        { "id": 10369, "createdAt": "2025-11-16T07:58:00.665Z", "volume": 3980909513.023723 },
        { "id": 10171, "createdAt": "2025-11-16T01:58:01.020Z", "volume": 4509583750.104479 },
        { "id": 9973,  "createdAt": "2025-11-15T19:58:00.921Z", "volume": 5585793166.709064 },
        { "id": 9775,  "createdAt": "2025-11-15T13:58:00.771Z", "volume": 8572181251.050555 },
        { "id": 9577,  "createdAt": "2025-11-15T07:58:00.717Z", "volume": 11116735049.052109 },
        { "id": 9379,  "createdAt": "2025-11-15T01:58:00.763Z", "volume": 13065329770.360132 },
        { "id": 9181,  "createdAt": "2025-11-14T19:58:01.063Z", "volume": 14273770715.193874 },
        { "id": 9016,  "createdAt": "2025-11-14T14:58:00.984Z", "volume": 16760052217.686592 },
        { "id": 8851,  "createdAt": "2025-11-14T09:58:01.058Z", "volume": 14662141358.013706 },
        { "id": 8653,  "createdAt": "2025-11-14T03:58:00.675Z", "volume": 13194495859.7337 },
        { "id": 8455,  "createdAt": "2025-11-13T21:58:00.317Z", "volume": 12371548992.817318 },
        { "id": 8257,  "createdAt": "2025-11-13T15:58:00.895Z", "volume": 9475810839.676243 },
        { "id": 8059,  "createdAt": "2025-11-13T09:58:00.827Z", "volume": 9288238252.501724 },
        { "id": 7861,  "createdAt": "2025-11-13T03:58:00.491Z", "volume": 8384977657.103944 },
        { "id": 7663,  "createdAt": "2025-11-12T21:58:01.130Z", "volume": 8060091541.545579 },
        { "id": 7465,  "createdAt": "2025-11-12T15:58:01.177Z", "volume": 7404125129.568744 },
        { "id": 7267,  "createdAt": "2025-11-12T09:58:00.911Z", "volume": 7457433407.045226 },
        { "id": 7069,  "createdAt": "2025-11-12T03:58:00.681Z", "volume": 8378500681.038304 },
        { "id": 6871,  "createdAt": "2025-11-11T21:58:00.794Z", "volume": 9230462579.399761 },
        { "id": 6673,  "createdAt": "2025-11-11T15:58:00.821Z", "volume": 9214140848.485579 },
        { "id": 6475,  "createdAt": "2025-11-11T09:58:01.093Z", "volume": 9466714298.374458 },
        { "id": 6277,  "createdAt": "2025-11-11T03:58:00.877Z", "volume": 8927100323.485464 },
        { "id": 6079,  "createdAt": "2025-11-10T21:58:01.210Z", "volume": 8914752864.751469 },
        { "id": 5881,  "createdAt": "2025-11-10T15:58:00.920Z", "volume": 8495471958.505926 },
        { "id": 5683,  "createdAt": "2025-11-10T09:58:00.725Z", "volume": 7481524248.595462 },
        { "id": 5485,  "createdAt": "2025-11-10T03:58:01.017Z", "volume": 6901671678.00537 },
        { "id": 5287,  "createdAt": "2025-11-09T21:58:01.831Z", "volume": 5497153472.837633 },
        { "id": 5089,  "createdAt": "2025-11-09T15:58:02.431Z", "volume": 4875005115.738722 },
        { "id": 4891,  "createdAt": "2025-11-09T09:58:00.339Z", "volume": 4347592165.000299 },
        { "id": 4693,  "createdAt": "2025-11-09T03:58:00.858Z", "volume": 4996763460.813761 },
        { "id": 4495,  "createdAt": "2025-11-08T21:58:00.694Z", "volume": 5964518372.183982 },
        { "id": 4297,  "createdAt": "2025-11-08T15:58:00.621Z", "volume": 8536530163.420262 },
        { "id": 4099,  "createdAt": "2025-11-08T09:58:00.746Z", "volume": 11426493176.16062 },
        { "id": 3901,  "createdAt": "2025-11-08T03:58:00.881Z", "volume": 11500754249.872984 },
        { "id": 3868,  "createdAt": "2025-11-08T02:58:00.875Z", "volume": 11463093476.001806 }
    ],
    "nextCursor": "BEARER_KEY"
}
```

{% endcode %}

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.coinmarketman.com/endpoints/stats-page-data.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
