# Positions & Market Data The Positions & Market Exposure endpoints provide comprehensive access to trading position data and market analytics. These endpoints allow you to retrieve detailed position information, analyze market exposure by coin and segment (cohort), rank positions by various metrics, and monitor the overall market landscape across different trader cohorts. *** ### Get All Open Positions `/api/external/positions/open/coin/{coin}` {% hint style="success" %} **Unique to HyperTracker Users** {% endhint %} Returns a full snapshot of every open perpetual position for a given coin across Hyperliquid, including both the main DEX and all HIP-3 exchanges. This provides complete market coverage in a single request, typically including tens of thousands of positions. Each position is enriched with detailed position-level metrics and higher-level wallet intelligence, allowing you to analyse individual open positions, trader behaviour, and cohort dynamics. The dataset represents the latest completed market snapshot and is refreshed approximately every 15–20 minutes, in line with Hyperliquid state updates.
Path Parameters
ParameterTypeDescription
coinstringCoin symbol to download positions for. Case-insensitive. Examples: BTC, ETH.
Request Examples {% tabs %} {% tab title="Curl" %} ``` curl --request GET \ --location \ --url 'https://ht-api.coinmarketman.com/api/external/positions/open/coin/BTC' \ --header 'Authorization: Bearer YOUR_API_TOKEN' \ --header 'Accept: text/csv' ``` {% endtab %} {% tab title="Python" %} ``` import requests response = requests.get( "https://ht-api.coinmarketman.com/api/external/positions/open/coin/BTC", headers={ "Authorization": "Bearer YOUR_API_TOKEN", "Accept": "text/csv", }, allow_redirects=True, ) response.raise_for_status() csv_data = response.text print(csv_data) ``` {% endtab %} {% tab title="Javascript" %} ``` const response = await fetch( 'https://ht-api.coinmarketman.com/api/external/positions/open/coin/BTC', { headers: { Authorization: 'Bearer YOUR_API_TOKEN', Accept: 'text/csv' }, redirect: 'follow' } ); if (!response.ok) { throw new Error(`Request failed: ${response.status} ${response.statusText}`); } const csv = await response.text(); console.log(csv); ``` {% endtab %} {% endtabs %} Response > **302 Redirect:** Redirects to a short-lived pre-signed URL for the latest open positions CSV file for the requested coin.
CSV content preview {% code expandable="true" %} ``` [ { "id": "4c16b579bc1f258ff0935e7ac44fe39518ff74b7c696cff5e21fde9c409941b5", "address": "0xa5b0edf6b55128e0ddae8e51ac538c3188401d41", "coin": "BTC", "side": "long", "dex": "main", "size": 700.0, "value": 47473300.0, "entryPrice": 68420.24587, "unrealizedPnl": -420872.1093, "funding": -52837.50306, "liquidationPrice": 27965.013971, "liquidationProgress": 1.486200527786029, "crossLeverage": 20, "isolatedLeverage": 0, "openTime": "2026-03-02T20:27:24.000Z", "profile_totalEquity": 31042191.967027, "profile_perpEquity": 31042191.967027, "profile_countOpenPositions": 2, "profile_pnl": 370800.216882, "profile_balance": 31042191.967027, "profile_perpPnlSegmentId": 9, "profile_sizeSegmentId": 7 }, { "id": "a217b26172e2d52a002049b400966a4fce10967fc1b818032033c467b3074942", "address": "0x082e843a431aef031264dc232693dd710aedca88", "coin": "BTC", "side": "long", "dex": "main", "size": 250.0, "value": 16954750.0, "entryPrice": 66819.0, "unrealizedPnl": 250000.0, "funding": -10141.52, "liquidationPrice": 1213.15, "liquidationProgress": 4.14, "crossLeverage": 20, "isolatedLeverage": 0, "openTime": "2026-02-18T22:44:00.000Z", "profile_totalEquity": 18472178.849423, "profile_perpEquity": 18472178.849423, "profile_countOpenPositions": 4, "profile_pnl": 3564355.038546, "profile_balance": 18472178.849423, "profile_perpPnlSegmentId": 8, "profile_sizeSegmentId": 7 }, { "id": "31541bc8b7cd222f71648a33cdde29b921da88d3d5e718cf97aa9afb5b35d821", "address": "0xeadc152ac1014ace57c6b353f89adf5faffe9d55", "coin": "BTC", "side": "long", "dex": "main", "size": 150.0, "value": 10172850.0, "entryPrice": 68021.0, "unrealizedPnl": -20250.0, "funding": -20433.0, "liquidationPrice": 5122.0, "liquidationProgress": 3.87, "crossLeverage": 20, "isolatedLeverage": 0, "openTime": "2026-03-12T20:13:30.000Z", "profile_totalEquity": 31186378.24408, "profile_perpEquity": 31186378.24408, "profile_countOpenPositions": 3, "profile_pnl": 2776726.133462, "profile_balance": 31186378.24408, "profile_perpPnlSegmentId": 8, "profile_sizeSegmentId": 7 }, { "id": "e4f6010060573335113a11ca8b8de322fd84f66c8512516ce5669d35113a11ca", "address": "0x6c8512516ce5669d35113a11ca8b8de322fd84f6", "coin": "BTC", "side": "long", "dex": "main", "size": 125.0, "value": 8477375.0, "entryPrice": 67011.0, "unrealizedPnl": 101000.0, "funding": -3225.0, "liquidationPrice": 1004.0, "liquidationProgress": 2.45, "crossLeverage": 20, "isolatedLeverage": 0, "openTime": "2026-01-25T18:41:54.000Z", "profile_totalEquity": 11583400.515941, "profile_perpEquity": 11583400.515941, "profile_countOpenPositions": 1, "profile_pnl": 1513793.559309, "profile_balance": 11583400.515941, "profile_perpPnlSegmentId": 8, "profile_sizeSegmentId": 7 }, { "id": "1804f9b096385c4e66ce3dec9a17e150795b9a02e3f5b0edf6b55128e0ddae8", "address": "0x4f9b096385c4e66ce3dec9a17e150795b9a02e3f", "coin": "BTC", "side": "long", "dex": "main", "size": 100.0, "value": 6781900.0, "entryPrice": 65546.0, "unrealizedPnl": 227300.0, "funding": -1071.0, "liquidationPrice": 512.0, "liquidationProgress": 1.34, "crossLeverage": 20, "isolatedLeverage": 0, "openTime": "2026-01-08T14:47:26.000Z", "profile_totalEquity": 2301924.587461, "profile_perpEquity": 2301924.587461, "profile_countOpenPositions": 1, "profile_pnl": 775860.058126, "profile_balance": 2301924.587461, "profile_perpPnlSegmentId": 9, "profile_sizeSegmentId": 6 }, { "id": "985f02b19dbc062e565c981aac5614baf2cf501f60dc8e3dad2e4e0738e813b9", "address": "0x985f02b19dbc062e565c981aac5614baf2cf501f", "coin": "ETH", "side": "short", "dex": "main", "size": 12.5, "value": 28000.0, "entryPrice": 2240.0, "unrealizedPnl": 1250.0, "funding": 145.0, "liquidationPrice": 3615.0, "liquidationProgress": 0.32, "crossLeverage": 10, "isolatedLeverage": 0, "openTime": "2026-03-17T20:51:18.000Z", "profile_totalEquity": 19022717.393541, "profile_perpEquity": 19022717.393541, "profile_countOpenPositions": 8, "profile_pnl": 607348.752187, "profile_balance": 19022717.393541, "profile_perpPnlSegmentId": 9, "profile_sizeSegmentId": 7 }, { "id": "557edb253b1d7ed5f15b248a5a3fd919fa5d3c814ecd58def11dc3cadf7deb09", "address": "0x557edb253b1d7ed5f15b248a5a3fd919fa5d3c81", "coin": "BTC", "side": "long", "dex": "main", "size": 0.1, "value": 6781.9, "entryPrice": 68012.0, "unrealizedPnl": -23.1, "funding": -2.4, "liquidationPrice": 451.0, "liquidationProgress": 0.08, "crossLeverage": 50, "isolatedLeverage": 0, "openTime": "2026-03-24T18:43:11.000Z", "profile_totalEquity": 2302.429994, "profile_perpEquity": 2302.429994, "profile_countOpenPositions": 2, "profile_pnl": 2320.761655, "profile_balance": 2302.429994, "profile_perpPnlSegmentId": 11, "profile_sizeSegmentId": 1 }, { "id": "42f3226007290b02c5a0b15bccbb1ba6df04f9923e0ef9ad4096c30acefbf7a9", "address": "0x42f3226007290b02c5a0b15bccbb1ba6df04f992", "coin": "ETH", "side": "long", "dex": "main", "size": 5.0, "value": 11200.0, "entryPrice": 2235.0, "unrealizedPnl": 25.0, "funding": -1.2, "liquidationPrice": 312.0, "liquidationProgress": 0.14, "crossLeverage": 20, "isolatedLeverage": 0, "openTime": "2026-03-12T11:52:41.000Z", "profile_totalEquity": 1865.4829, "profile_perpEquity": 1865.4829, "profile_countOpenPositions": 1, "profile_pnl": 1810.938282, "profile_balance": 1865.4829, "profile_perpPnlSegmentId": 11, "profile_sizeSegmentId": 2 }, { "id": "22047776933bc123d0602ed17aaf0d2f5647df0c6633d75e488fae2a19b0242c", "address": "0x22047776933bc123d0602ed17aaf0d2f5647df0c", "coin": "BTC", "side": "long", "dex": "main", "size": 0.05, "value": 3390.95, "entryPrice": 67555.0, "unrealizedPnl": 13.5, "funding": -0.8, "liquidationPrice": 123.0, "liquidationProgress": 0.04, "crossLeverage": 50, "isolatedLeverage": 0, "openTime": "2026-03-16T14:40:49.000Z", "profile_totalEquity": 1149.423129, "profile_perpEquity": 1149.423129, "profile_countOpenPositions": 3, "profile_pnl": 1130.446224, "profile_balance": 1149.423129, "profile_perpPnlSegmentId": 11, "profile_sizeSegmentId": 1 }, { "id": "3342ee6851ef0ec3cf42658c2be3b28a905271aa24a747628494231347f4f6ae", "address": "0x3342ee6851ef0ec3cf42658c2be3b28a905271aa", "coin": "ETH", "side": "long", "dex": "main", "size": 1.5, "value": 3360.0, "entryPrice": 2231.0, "unrealizedPnl": 13.5, "funding": -0.4, "liquidationPrice": 85.0, "liquidationProgress": 0.03, "crossLeverage": 20, "isolatedLeverage": 0, "openTime": "2026-03-24T11:48:41.000Z", "profile_totalEquity": 380.278541, "profile_perpEquity": 380.278541, "profile_countOpenPositions": 1, "profile_pnl": 364.613446, "profile_balance": 380.278541, "profile_perpPnlSegmentId": 11, "profile_sizeSegmentId": 1 }, { "id": "23ff884fab981b7e8b5c43f56d64cd29d1fad4f70d1db1c800184a203915757b", "address": "0x23ff884fab981b7e8b5c43f56d64cd29d1fad4f7", "coin": "BTC", "side": "short", "dex": "main", "size": 0.01, "value": 678.19, "entryPrice": 67912.0, "unrealizedPnl": 0.9, "funding": 0.1, "liquidationPrice": 125000.0, "liquidationProgress": 0.01, "crossLeverage": 20, "isolatedLeverage": 0, "openTime": "2026-03-25T13:41:44.000Z", "profile_totalEquity": 321.593207, "profile_perpEquity": 321.593207, "profile_countOpenPositions": 1, "profile_pnl": 274.865319, "profile_balance": 321.593207, "profile_perpPnlSegmentId": 11, "profile_sizeSegmentId": 1 }, { "id": "0abc2f5441ca1e88280c2d67d589e47e0de113639af5148d9294b3d0a7b82ecb", "address": "0x0abc2f5441ca1e88280c2d67d589e47e0de11363", "coin": "ETH", "side": "short", "dex": "main", "size": 0.25, "value": 560.0, "entryPrice": 2245.0, "unrealizedPnl": 1.25, "funding": 0.1, "liquidationPrice": 5120.0, "liquidationProgress": 0.01, "crossLeverage": 20, "isolatedLeverage": 0, "openTime": "2026-03-26T08:13:58.000Z", "profile_totalEquity": 0.027088, "profile_perpEquity": 0.027088, "profile_countOpenPositions": 1, "profile_pnl": 0.024998, "profile_balance": 0.027088, "profile_perpPnlSegmentId": 11, "profile_sizeSegmentId": 1 }, { "id": "b1d5e976a1479f8c5f5571769cd6b9f06496139d4100ffccff56d8d0d3161ab1", "address": "0xb1d5e976a1479f8c5f5571769cd6b9f06496139d", "coin": "BTC", "side": "long", "dex": "main", "size": 0.005, "value": 339.09, "entryPrice": 67800.0, "unrealizedPnl": 0.1, "funding": -0.1, "liquidationPrice": 5.0, "liquidationProgress": 0.0, "crossLeverage": 100, "isolatedLeverage": 0, "openTime": "2026-03-26T07:29:00.000Z", "profile_totalEquity": 0.868885, "profile_perpEquity": 0.868885, "profile_countOpenPositions": 1, "profile_pnl": 0.843124, "profile_balance": 0.868885, "profile_perpPnlSegmentId": 11, "profile_sizeSegmentId": 1 }, { "id": "e8e4305ecef9d2c13c7301a1dae44a9309ba76ce3f88705654afd85f67602fce", "address": "0xe8e4305ecef9d2c13c7301a1dae44a9309ba76ce", "coin": "BTC", "side": "short", "dex": "main", "size": 0.002, "value": 135.63, "entryPrice": 67900.0, "unrealizedPnl": 0.17, "funding": 0.0, "liquidationPrice": 150000.0, "liquidationProgress": 0.0, "crossLeverage": 20, "isolatedLeverage": 0, "openTime": "2026-03-26T05:22:50.000Z", "profile_totalEquity": 0.811317, "profile_perpEquity": 0.811317, "profile_countOpenPositions": 1, "profile_pnl": 0.705659, "profile_balance": 0.811317, "profile_perpPnlSegmentId": 11, "profile_sizeSegmentId": 1 }, { "id": "a5c0d8a71048414c086c45fd86a2ee94fc5df16a3cfe16fdb8418cb08062e3f3", "address": "0xa5c0d8a71048414c086c45fd86a2ee94fc5df16a", "coin": "ETH", "side": "long", "dex": "main", "size": 0.1, "value": 224.0, "entryPrice": 2238.0, "unrealizedPnl": 0.2, "funding": 0.0, "liquidationPrice": 5.0, "liquidationProgress": 0.0, "crossLeverage": 10, "isolatedLeverage": 0, "openTime": "2026-03-26T00:41:48.000Z", "profile_totalEquity": 0.0, "profile_perpEquity": 0.0, "profile_countOpenPositions": 1, "profile_pnl": 0.0, "profile_balance": 0.0, "profile_perpPnlSegmentId": 12, "profile_sizeSegmentId": 1 }, { "id": "0x3cfe16fdb8418cb08062e3f34d7cd5db8d0eb7ec", "address": "0x3cfe16fdb8418cb08062e3f34d7cd5db8d0eb7ec", "coin": "BTC", "side": "short", "dex": "main", "size": 0.01, "value": 678.19, "entryPrice": 67812.0, "unrealizedPnl": -0.07, "funding": 0.0, "liquidationPrice": 98000.0, "liquidationProgress": 0.01, "crossLeverage": 20, "isolatedLeverage": 0, "openTime": "2026-03-24T16:37:51.000Z", "profile_totalEquity": 0.0, "profile_perpEquity": 0.0, "profile_countOpenPositions": 1, "profile_pnl": 0.0, "profile_balance": 0.0, "profile_perpPnlSegmentId": 12, "profile_sizeSegmentId": 1 }, { "id": "30f679c4da2e100f177f164825e917d4dd5fe3", "address": "0x30f679c4da2e100f177f164825e917d4dd5fe3", "coin": "BTC", "side": "long", "dex": "main", "size": 0.00001, "value": 0.67819, "entryPrice": 78350.0, "unrealizedPnl": -0.10531, "funding": -37.655092, "liquidationPrice": 0.0, "liquidationProgress": 13.44097000638162, "crossLeverage": 20, "isolatedLeverage": 0, "openTime": "2026-01-31T22:35:54.000Z", "profile_totalEquity": 30867.137468, "profile_perpEquity": 30867.137612, "profile_countOpenPositions": 2, "profile_pnl": -42518.182532, "profile_balance": 30867.137612, "profile_perpPnlSegmentId": 13, "profile_sizeSegmentId": 2 }, { "id": "1634cf2cceb7a2929ea886a6eda34e141de8ad92e71bc7059767fc1b868bb251", "address": "0xcb47bddc3cfc9ea44ee83a9b59acfb7a7772a77f", "coin": "BTC", "side": "short", "dex": "main", "size": 0.00001, "value": 0.67819, "entryPrice": 87997.0, "unrealizedPnl": 0.20178, "funding": 0.009255, "liquidationPrice": 131287.407407, "liquidationProgress": 0.0, "crossLeverage": 0, "isolatedLeverage": 2, "openTime": "2025-12-21T18:26:02.000Z", "profile_totalEquity": 0.6509, "profile_perpEquity": 0.6509, "profile_countOpenPositions": 2, "profile_pnl": -394.67, "profile_balance": 0.6509, "profile_perpPnlSegmentId": 12, "profile_sizeSegmentId": 16 } ] ``` {% endcode %}
*** ### Get Historic Positions `/api/external/positions` {% hint style="success" %} **Unique to HyperTracker Users** {% endhint %} Provides a historical record of Hyperliquid perp positions captured by HyperTracker within the requested time window. Each unique position is returned **once** per request window, even if it remained open across multiple Hyperliquid state updates during that period. `openTime` shows when the position opened. `closeTime: null` means the position is **currently still open**, not merely that it was open during the queried window. If the position has since closed, the endpoint should return the actual `closeTime`, even when the queried window was from an earlier part of that position’s lifecycle. `createdAt` shows when the record was written into HyperTracker’s database. This endpoint currently returns one consolidated record per unique position per request window, not every per-state progression for the same position.
Query Parameters
ParameterTypeDescription
limitnumberMaximum number of positions to return per request.
coinstringCoin symbol to filter by (for example ETH, BTC, LINEA). If omitted, positions for all coins are returned.
nextCursorstringCursor for pagination. Use the nextCursor value from the previous response to fetch the next page.
addressstringOne or more wallet addresses to include.
startstringStart of the time window (ISO 8601, UTC).
endstringEnd of the time window (ISO 8601, UTC). If omitted, the API uses “now”.
openbooleanFilter by position status. true returns only open positions, false returns only closed positions. If omitted, both are returned.
segmentIdnumberFilter 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 {% tabs %} {% tab title="Curl" %} ``` curl --request GET \ --url 'https://api.example.com/api/external/positions?limit=50&orderBy=pnl&order=desc' \ --header 'Authorization: Bearer YOUR_API_TOKEN' ``` {% endtab %} {% tab title="JavaScript" %} ``` const res = await fetch( 'https://api.example.com/api/external/positions?limit=50&orderBy=pnl&order=desc', { headers: { Authorization: 'Bearer YOUR_API_TOKEN' } } ); const data = await res.json(); ``` {% endtab %} {% tab title="Python" %} ``` import requests response = requests.get( "https://ht-api.coinmarketman.com/api/external/positions", params={"limit": 50, "orderBy": "pnl", "order": "desc"}, headers={ "Authorization": "Bearer YOUR_API_TOKEN", }, ) result = response.json() ``` {% endtab %} {% endtabs %} Response > 200 Success: Returns a list of positions that match the provided filters. Pagination is supported via `nextCursor`.
Response Example {% code expandable="true" %} ``` { "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": "BEARER_TOKEN" } ``` {% endcode %}
*** ### Get Market-Wide Open Interest Snapshot `/api/external/positions/coins` {% hint style="success" %} **Unique to HyperTracker Users** {% endhint %} Returns a live market-wide snapshot of open interest across every coin. Each coin includes total open interest, total position count, and long/short position counts. Results are sorted by `totalValue` descending. Note: `totalValueLong` and `totalValueShort` represent both sides of total open interest and will usually match at the market level. Request Examples {% tabs %} {% tab title="Curl" %} ``` curl -X GET \ 'https://ht-api.coinmarketman.com/api/external/positions/coins' \ -H 'accept: application/json' \ -H 'Authorization: Bearer YOUR_API_TOKEN' ``` {% endtab %} {% tab title="Python" %} ``` import requests response = requests.get( "https://ht-api.coinmarketman.com/api/external/positions/coins", headers={ "accept": "application/json", "Authorization": "Bearer YOUR_API_TOKEN", }, ) result = response.json() ``` {% endtab %} {% endtabs %} Response > 200 Success: Returns all coins with open positions, sorted by `totalValue` descending.
Response Example {% code expandable="true" %} ``` [ { "coin": "BTC", "totalValue": 1765951118.63036, "totalValueLong": 882975559.31518, "totalValueShort": 882975559.31518, "count": 25640, "countLong": 13706, "countShort": 11934 }, { "coin": "ETH", "totalValue": 1235590741.88172, "totalValueLong": 617795370.94086, "totalValueShort": 617795370.94086, "count": 12834, "countLong": 7212, "countShort": 5622 }, { "coin": "HYPE", "totalValue": 806717586.6918, "totalValueLong": 403358793.3459, "totalValueShort": 403358793.3459, "count": 11446, "countLong": 7747, "countShort": 3699 }, { "coin": "SOL", "totalValue": 328269934.76592, "totalValueLong": 164134967.38296, "totalValueShort": 164134967.38296, "count": 8802, "countLong": 5497, "countShort": 3305 }, { "coin": "xyz:BRENTOIL", "totalValue": 281168989.75684, "totalValueLong": 140584494.87842, "totalValueShort": 140584494.87842, "count": 2276, "countLong": 1801, "countShort": 475 }, { "coin": "xyz:GOLD", "totalValue": 176855530.61352, "totalValueLong": 88427765.30676, "totalValueShort": 88427765.30676, "count": 3787, "countLong": 3065, "countShort": 722 }, { "coin": "xyz:SILVER", "totalValue": 120338483.02224, "totalValueLong": 60169241.51112, "totalValueShort": 60169241.51112, "count": 2660, "countLong": 2050, "countShort": 610 }, { "coin": "xyz:SP500", "totalValue": 91016161.9192, "totalValueLong": 45508080.9596, "totalValueShort": 45508080.9596, "count": 1431, "countLong": 671, "countShort": 760 }, { "coin": "XRP", "totalValue": 71779486.54, "totalValueLong": 35889743.27, "totalValueShort": 35889743.27, "count": 3537, "countLong": 1720, "countShort": 1817 }, { "coin": "TAO", "totalValue": 67034833.76916, "totalValueLong": 33517416.88458, "totalValueShort": 33517416.88458, "count": 3278, "countLong": 2349, "countShort": 929 }, { "coin": "xyz:NVDA", "totalValue": 55668024.18784, "totalValueLong": 27834012.09392, "totalValueShort": 27834012.09392, "count": 1954, "countLong": 1256, "countShort": 698 }, { "coin": "hyna:BTC", "totalValue": 38283167.558954, "totalValueLong": 19141583.779477, "totalValueShort": 19141583.779477, "count": 641, "countLong": 358, "countShort": 283 }, { "coin": "cash:USA500", "totalValue": 34492601.1836, "totalValueLong": 17246300.5918, "totalValueShort": 17246300.5918, "count": 461, "countLong": 169, "countShort": 292 }, { "coin": "LINK", "totalValue": 28718043.86628, "totalValueLong": 14359021.93314, "totalValueShort": 14359021.93314, "count": 2423, "countLong": 1484, "countShort": 939 }, { "coin": "kPEPE", "totalValue": 25785148.565904, "totalValueLong": 12892574.282952, "totalValueShort": 12892574.282952, "count": 944, "countLong": 530, "countShort": 414 }, { "coin": "xyz:TSLA", "totalValue": 20687021.83976, "totalValueLong": 10343510.91988, "totalValueShort": 10343510.91988, "count": 1357, "countLong": 753, "countShort": 604 }, { "coin": "xyz:GOOGL", "totalValue": 19738477.61976, "totalValueLong": 9869238.80988, "totalValueShort": 9869238.80988, "count": 939, "countLong": 630, "countShort": 309 }, { "coin": "DOGE", "totalValue": 20819727.59838, "totalValueLong": 10409863.79919, "totalValueShort": 10409863.79919, "count": 2669, "countLong": 1169, "countShort": 1500 }, { "coin": "SUI", "totalValue": 16777689.720792, "totalValueLong": 8388844.860396, "totalValueShort": 8388844.860396, "count": 2533, "countLong": 982, "countShort": 1551 }, { "coin": "flx:OIL", "totalValue": 6497041.27776, "totalValueLong": 3248520.63888, "totalValueShort": 3248520.63888, "count": 276, "countLong": 232, "countShort": 44 }, { "coin": "xyz:AAPL", "totalValue": 5377829.41212, "totalValueLong": 2688914.70606, "totalValueShort": 2688914.70606, "count": 512, "countLong": 344, "countShort": 168 }, { "coin": "cash:GOLD", "totalValue": 4069409.72214, "totalValueLong": 2034704.86107, "totalValueShort": 2034704.86107, "count": 104, "countLong": 80, "countShort": 24 }, { "coin": "vntl:MAG7", "totalValue": 2219694.484446, "totalValueLong": 1109847.242223, "totalValueShort": 1109847.242223, "count": 105, "countLong": 47, "countShort": 58 }, { "coin": "vntl:SPACEX", "totalValue": 1768424.6394, "totalValueLong": 884212.3197, "totalValueShort": 884212.3197, "count": 338, "countLong": 294, "countShort": 44 }, { "coin": "km:US500", "totalValue": 3659844.62526, "totalValueLong": 1829922.31263, "totalValueShort": 1829922.31263, "count": 234, "countLong": 108, "countShort": 126 }, { "coin": "flx:GOLD", "totalValue": 1360947.1584, "totalValueLong": 680473.5792, "totalValueShort": 680473.5792, "count": 108, "countLong": 91, "countShort": 17 }, { "coin": "vntl:ANTHROPIC", "totalValue": 1117108.291, "totalValueLong": 558554.1455, "totalValueShort": 558554.1455, "count": 220, "countLong": 195, "countShort": 25 }, { "coin": "hyna:ETH", "totalValue": 6547578.73236, "totalValueLong": 3273789.36618, "totalValueShort": 3273789.36618, "count": 282, "countLong": 139, "countShort": 143 }, { "coin": "km:SILVER", "totalValue": 927039.43548, "totalValueLong": 463519.71774, "totalValueShort": 463519.71774, "count": 78, "countLong": 57, "countShort": 21 }, { "coin": "flx:PALLADIUM", "totalValue": 348865.6896, "totalValueLong": 174432.8448, "totalValueShort": 174432.8448, "count": 26, "countLong": 18, "countShort": 8 }, { "coin": "km:SEMI", "totalValue": 17186.22108, "totalValueLong": 8593.11054, "totalValueShort": 8593.11054, "count": 5, "countLong": 3, "countShort": 2 } ] ``` {% endcode %}
*** ### Get Open Interest & Position Count Time Series (Coin) `/api/external/position-metrics/coin/{coin}`
{% hint style="success" %} **Unique to HyperTracker Users** Full-market position snapshots captured on every state update not available via the Hyperliquid API. {% endhint %} Returns high-frequency historical snapshots of open interest and position count for a selected coin, captured on every state update. Each snapshot includes total open interest, position count, long-side breakdowns, funding, unrealised PnL, and total position size across the entire market.
Path Parameters
ParameterTypeRequiredDescription
coinstring✅Required: Coin ticker (for example BTC, ETH).
Query Parameters
ParameterTypeRequiredDescription
limitnumberOptionalMaximum number of metric rows to return in one response.
nextCursorstringOptionalCursor for pagination. Pass the value from the previous response to fetch the next page.
startstring✅Required: Start of the time window (ISO8601).
endstringOptionalEnd of the time window (ISO 8601, UTC). If omitted, the API uses “now”.
Request Examples {% tabs %} {% tab title="Curl" %} ``` curl --request GET \ --url 'https://ht-api.coinmarketman.com/api/external/position-metrics/coin/BTC?end=2026-03-26T19%3A21%3A19.809Z&start=2026-03-25T19%3A21%3A19.809Z' \ --header 'Authorization: Bearer YOUR_API_TOKEN' ``` {% endtab %} {% tab title="Python" %} ``` import requests response = requests.get( 'https://ht-api.coinmarketman.com/api/external/position-metrics/coin/BTC', 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 metric snapshots for the requested coin, plus an optional cursor for pagination. Note: Long and short position sizes will always balance at the market level.
Response Example {% code expandable="true" %} ``` { "metrics": [ { "id": 7474614, "createdAt": "2026-04-26T13:45:56.957Z", "coin": "BTC", "positionCount": 31194, "positionCountLong": 16293, "totalPositionValue": 2126726735.67504, "totalPositionValueLong": 1063363367.83752, "totalFunding": 6966185.581577, "totalUnrealizedPnl": -13828887.101559, "totalPositionSize": 27325.98468, "totalPositionSizeLong": 13662.99234 }, { "id": 7474284, "createdAt": "2026-04-26T13:30:35.360Z", "coin": "BTC", "positionCount": 31169, "positionCountLong": 16232, "totalPositionValue": 2126041595.48246, "totalPositionValueLong": 1063020797.74123, "totalFunding": 6966185.101995, "totalUnrealizedPnl": -13821204.33152, "totalPositionSize": 27292.28354, "totalPositionSizeLong": 13646.14177 }, { "id": 7473954, "createdAt": "2026-04-26T13:14:44.999Z", "coin": "BTC", "positionCount": 31140, "positionCountLong": 16202, "totalPositionValue": 2120976263.46, "totalPositionValueLong": 1060488131.73, "totalFunding": 6966185.989036, "totalUnrealizedPnl": -13813470.50824, "totalPositionSize": 27261.9057, "totalPositionSizeLong": 13630.95285 }, { "id": 7473624, "createdAt": "2026-04-26T12:58:40.910Z", "coin": "BTC", "positionCount": 31228, "positionCountLong": 16281, "totalPositionValue": 2113197799.157, "totalPositionValueLong": 1056598899.5785, "totalFunding": 6965788.568494, "totalUnrealizedPnl": -13777572.440069, "totalPositionSize": 27116.6149, "totalPositionSizeLong": 13558.30745 }, { "id": 7473294, "createdAt": "2026-04-26T12:43:04.113Z", "coin": "BTC", "positionCount": 31211, "positionCountLong": 16268, "totalPositionValue": 2112176017.1876, "totalPositionValueLong": 1056088008.5938, "totalFunding": 6965779.997045, "totalUnrealizedPnl": -13772877.870719, "totalPositionSize": 27090.9886, "totalPositionSizeLong": 13545.4943 }, { "id": 7472964, "createdAt": "2026-04-26T12:27:31.131Z", "coin": "BTC", "positionCount": 31214, "positionCountLong": 16286, "totalPositionValue": 2113683645.77606, "totalPositionValueLong": 1056841822.88803, "totalFunding": 6965774.448134, "totalUnrealizedPnl": -13772591.977677, "totalPositionSize": 27096.07658, "totalPositionSizeLong": 13548.03829 }, { "id": 7472634, "createdAt": "2026-04-26T12:10:59.207Z", "coin": "BTC", "positionCount": 31166, "positionCountLong": 16242, "totalPositionValue": 2121939455.66218, "totalPositionValueLong": 1060969727.83109, "totalFunding": 6965769.643282, "totalUnrealizedPnl": -13776481.201499, "totalPositionSize": 27179.61158, "totalPositionSizeLong": 13589.80579 }, { "id": 7472304, "createdAt": "2026-04-26T11:54:32.772Z", "coin": "BTC", "positionCount": 31159, "positionCountLong": 16219, "totalPositionValue": 2119376037.91536, "totalPositionValueLong": 1059688018.95768, "totalFunding": 6965704.155058, "totalUnrealizedPnl": -13774480.299557, "totalPositionSize": 27158.25672, "totalPositionSizeLong": 13579.12836 }, { "id": 7471974, "createdAt": "2026-04-26T11:39:34.759Z", "coin": "BTC", "positionCount": 31111, "positionCountLong": 16196, "totalPositionValue": 2116689080.73468, "totalPositionValueLong": 1058344540.36734, "totalFunding": 6965676.64043, "totalUnrealizedPnl": -13789564.654972, "totalPositionSize": 27132.16962, "totalPositionSizeLong": 13566.08481 }, { "id": 7471644, "createdAt": "2026-04-26T11:23:31.751Z", "coin": "BTC", "positionCount": 31063, "positionCountLong": 16199, "totalPositionValue": 2108964050.75298, "totalPositionValueLong": 1054482025.37649, "totalFunding": 6965757.791959, "totalUnrealizedPnl": -13784299.340457, "totalPositionSize": 27041.12078, "totalPositionSizeLong": 13520.56039 }, { "id": 7471314, "createdAt": "2026-04-26T11:07:39.646Z", "coin": "BTC", "positionCount": 31065, "positionCountLong": 16208, "totalPositionValue": 2103953990.8716, "totalPositionValueLong": 1051976995.4358, "totalFunding": 6965823.377944, "totalUnrealizedPnl": -13787366.676733, "totalPositionSize": 26994.53414, "totalPositionSizeLong": 13497.26707 }, { "id": 7470984, "createdAt": "2026-04-26T10:51:24.411Z", "coin": "BTC", "positionCount": 31057, "positionCountLong": 16198, "totalPositionValue": 2105625950.52032, "totalPositionValueLong": 1052812975.26016, "totalFunding": 6965815.770484, "totalUnrealizedPnl": -13785456.736741, "totalPositionSize": 27004.89856, "totalPositionSizeLong": 13502.44928 }, { "id": 7470654, "createdAt": "2026-04-26T10:36:01.249Z", "coin": "BTC", "positionCount": 31064, "positionCountLong": 16208, "totalPositionValue": 2106172425.75648, "totalPositionValueLong": 1053086212.87824, "totalFunding": 6965824.265419, "totalUnrealizedPnl": -13785389.987082, "totalPositionSize": 27001.51824, "totalPositionSizeLong": 13500.75912 }, { "id": 7470324, "createdAt": "2026-04-26T10:19:40.899Z", "coin": "BTC", "positionCount": 31047, "positionCountLong": 16211, "totalPositionValue": 2105419247.47602, "totalPositionValueLong": 1052709623.73801, "totalFunding": 6965850.377955, "totalUnrealizedPnl": -13778403.152581, "totalPositionSize": 27010.21498, "totalPositionSizeLong": 13505.10749 }, { "id": 7469994, "createdAt": "2026-04-26T10:02:43.875Z", "coin": "BTC", "positionCount": 31048, "positionCountLong": 16246, "totalPositionValue": 2104285420.42624, "totalPositionValueLong": 1052142710.21312, "totalFunding": 6965794.43268, "totalUnrealizedPnl": -13756428.658925, "totalPositionSize": 26997.40096, "totalPositionSizeLong": 13498.70048 }, { "id": 7469664, "createdAt": "2026-04-26T09:46:37.454Z", "coin": "BTC", "positionCount": 31021, "positionCountLong": 16225, "totalPositionValue": 2106523500.24728, "totalPositionValueLong": 1053261750.12364, "totalFunding": 6965793.080872, "totalUnrealizedPnl": -13755234.686779, "totalPositionSize": 27016.40974, "totalPositionSizeLong": 13508.20487 }, { "id": 7469334, "createdAt": "2026-04-26T09:31:14.900Z", "coin": "BTC", "positionCount": 30985, "positionCountLong": 16216, "totalPositionValue": 2105444948.16082, "totalPositionValueLong": 1052722474.08041, "totalFunding": 6965872.785613, "totalUnrealizedPnl": -13762685.638915, "totalPositionSize": 27007.07998, "totalPositionSizeLong": 13503.53999 }, { "id": 7469004, "createdAt": "2026-04-26T09:15:08.480Z", "coin": "BTC", "positionCount": 30973, "positionCountLong": 16209, "totalPositionValue": 2101464742.3873, "totalPositionValueLong": 1050732371.19365, "totalFunding": 6965899.509858, "totalUnrealizedPnl": -13762883.221366, "totalPositionSize": 26945.6557, "totalPositionSizeLong": 13472.82785 }, { "id": 7468674, "createdAt": "2026-04-26T08:59:32.672Z", "coin": "BTC", "positionCount": 30714, "positionCountLong": 15946, "totalPositionValue": 2100275102.18608, "totalPositionValueLong": 1050137551.09304, "totalFunding": 6966155.411014, "totalUnrealizedPnl": -13746597.365689, "totalPositionSize": 26910.38864, "totalPositionSizeLong": 13455.19432 }, { "id": 7468344, "createdAt": "2026-04-26T08:43:38.200Z", "coin": "BTC", "positionCount": 30947, "positionCountLong": 16224, "totalPositionValue": 2096871242.03994, "totalPositionValueLong": 1048435621.01997, "totalFunding": 6966306.586103, "totalUnrealizedPnl": -13766849.061064, "totalPositionSize": 26873.66222, "totalPositionSizeLong": 13436.83111 }, { "id": 7468014, "createdAt": "2026-04-26T08:28:01.791Z", "coin": "BTC", "positionCount": 30927, "positionCountLong": 16175, "totalPositionValue": 2113297656.9537, "totalPositionValueLong": 1056648828.47685, "totalFunding": 6964078.202642, "totalUnrealizedPnl": -13731504.379217, "totalPositionSize": 27079.3257, "totalPositionSizeLong": 13539.66285 }, { "id": 7467684, "createdAt": "2026-04-26T08:11:22.830Z", "coin": "BTC", "positionCount": 30845, "positionCountLong": 16138, "totalPositionValue": 2086202284.03064, "totalPositionValueLong": 1043101142.01532, "totalFunding": 6964328.756364, "totalUnrealizedPnl": -13718232.728403, "totalPositionSize": 26736.58538, "totalPositionSizeLong": 13368.29269 }, { "id": 7467354, "createdAt": "2026-04-26T07:55:22.600Z", "coin": "BTC", "positionCount": 30832, "positionCountLong": 16137, "totalPositionValue": 2083739003.39808, "totalPositionValueLong": 1041869501.69904, "totalFunding": 6964317.497857, "totalUnrealizedPnl": -13716901.52638, "totalPositionSize": 26738.25568, "totalPositionSizeLong": 13369.12784 }, { "id": 7467024, "createdAt": "2026-04-26T07:39:35.719Z", "coin": "BTC", "positionCount": 30803, "positionCountLong": 16126, "totalPositionValue": 2085313892.93892, "totalPositionValueLong": 1042656946.46946, "totalFunding": 6964291.986899, "totalUnrealizedPnl": -13715547.763435, "totalPositionSize": 26736.85018, "totalPositionSizeLong": 13368.42509 }, { "id": 7466694, "createdAt": "2026-04-26T07:23:59.511Z", "coin": "BTC", "positionCount": 30755, "positionCountLong": 16109, "totalPositionValue": 2085813871.544, "totalPositionValueLong": 1042906935.772, "totalFunding": 6964264.424265, "totalUnrealizedPnl": -13714864.134652, "totalPositionSize": 26748.748, "totalPositionSizeLong": 13374.374 } ], "nextCursor": "eyJjcmVhdGVkQXQiOiIyMDI2LTA0LTI2VDA3OjIzOjU5LjUxMVoifQ.L4FzPJKM4ABwZQ5b6RldjDI2cLpuQc9eewGEkn8xL98" } ``` {% endcode %}
*** ### Export Open Interest & Position Count History (Coin) `/api/external/exports/coins/{coin}/position-metrics` {% hint style="success" %} **Unique to HyperTracker Users** Export-ready historical position metrics for a selected coin, sampled at 2-hour intervals. {% endhint %} Exports historical open interest and position count data for a selected coin in a compact column/data format.
Snapshots are sampled at 2-hour intervals and include total position count, long position count, total open interest, and long-side open interest. The `columns` array defines the order of values in each `data` row.
Path Parameters
ParameterTypeDescription
coinstringCoin symbol (case-insensitive), for example BTC, ETH.
Request Examples {% tabs %} {% tab title="Curl" %} ``` curl --request GET \ --url 'https://ht-api.coinmarketman.com/api/external/exports/coins/BTC/position-metrics' \ --header 'Authorization: Bearer YOUR_API_TOKEN' \ --location ``` {% endtab %} {% tab title="Python" %} ``` import requests response = requests.get( 'https://ht-api.coinmarketman.com/api/external/exports/coins/BTC/position-metrics', 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.
Response Example {% code expandable="true" %} ``` { "coin": "BTC", "metrics": { "columns": [ "coin", "timestamp", "positionCount", "positionCountLong", "totalPositionValue", "totalPositionValueLong" ], "data": [ ["2026-03-24T09:54:30.589Z", 25640, 13706, 1765951118.63036, 882975559.31518], ["2026-03-24T08:00:00.000Z", 25488, 13152, 1766198955.7212, 883099477.8606], ["2026-03-24T06:00:00.000Z", 25655, 12992, 1733810692.98744, 866905346.49372], ["2026-03-24T04:00:00.000Z", 25600, 12968, 1715803523.40644, 857901761.70322], ["2026-03-24T02:00:00.000Z", 25556, 12992, 1713680972.40384, 856840486.20192], ["2026-03-24T00:00:00.000Z", 25501, 12962, 1728152715.48128, 864076357.74064], ["2026-03-23T22:00:00.000Z", 25443, 12905, 1781051824.34576, 890525912.17288], ["2026-03-23T20:00:00.000Z", 25325, 12822, 1779972493.28976, 889986246.64488], ["2026-03-23T18:00:00.000Z", 25196, 12856, 1827849867.7554, 913924933.8777], ["2026-03-23T16:00:00.000Z", 24852, 12568, 1770007000.5952, 885003500.2976], ["2026-03-23T14:00:00.000Z", 24470, 12637, 1812248370.2352, 906124185.1176], ["2026-03-23T12:00:00.000Z", 24634, 12776, 1793341385.21416, 896670692.60708], ["2026-03-23T10:00:00.000Z", 25886, 13461, 1747494507.645, 873747253.8225], ["2026-03-23T08:00:00.000Z", 25746, 13444, 1743808608.777, 871904304.3885], ["2026-03-23T06:00:00.000Z", 25690, 13474, 1737122502.4839, 868561251.24195], ["2026-03-23T04:00:00.000Z", 25865, 13397, 1701215485.64928, 850607742.82464], ["2026-03-23T02:00:00.000Z", 25912, 13342, 1710561102.2496, 855280551.1248], ["2026-03-23T00:00:00.000Z", 25789, 13276, 1719504979.25484, 859752489.62742], ["2026-03-22T22:00:00.000Z", 25561, 12984, 1781161368.2072, 890580684.1036], ["2026-03-22T20:00:00.000Z", 26556, 13981, 1813345222.23306, 906672611.11653], ["2026-03-22T18:00:00.000Z", 26565, 14026, 1830387920.80402, 915193960.40201], ["2026-03-22T16:00:00.000Z", 26421, 13980, 1830808626.93108, 915404313.46554], ["2026-03-22T14:00:00.000Z", 26281, 13437, 1844737176.92648, 922368588.46324], ["2026-03-22T12:00:00.000Z", 26038, 13183, 1850311054.02234, 925155527.01117], ["2026-03-22T10:00:00.000Z", 26210, 13310, 1839093069.13024, 919546534.56512], ["2026-03-22T08:00:00.000Z", 25937, 13153, 1851189262.9929, 925594631.49645], ["2026-03-22T06:00:00.000Z", 25764, 13166, 1840702656.7743, 920351328.38715], ["2026-03-22T04:00:00.000Z", 25671, 13142, 1842157346.79636, 921078673.39818], ["2026-03-22T02:00:00.000Z", 25158, 12943, 1804662317.94578, 902331158.97289], ["2026-03-22T00:00:00.000Z", 24704, 12508, 1796392924.07048, 898196462.03524], ["2026-03-21T22:00:00.000Z", 26695, 14194, 1852206253.65936, 926103126.82968], ["2026-03-21T20:00:00.000Z", 26643, 14157, 1853809191.3649, 926904595.68245], ["2026-03-21T18:00:00.000Z", 26499, 14063, 1859424072.54912, 929712036.27456], ["2026-03-21T16:00:00.000Z", 26478, 14041, 1866973308.14064, 933486654.07032], ["2026-03-21T14:00:00.000Z", 26567, 14154, 1880864596.96866, 940432298.48433], ["2026-03-21T12:00:00.000Z", 26492, 14111, 1903903098.73632, 951951549.36816], ["2026-03-21T10:00:00.000Z", 26364, 13999, 1896074758.49898, 948037379.24949], ["2026-03-21T08:00:00.000Z", 26286, 14035, 1878875514.19298, 939437757.09649], ["2026-03-21T06:00:00.000Z", 26171, 13951, 1886970721.76844, 943485360.88422], ["2026-03-21T04:00:00.000Z", 26122, 13919, 1870295917.0392, 935147958.5196], ["2026-03-21T02:00:00.000Z", 25974, 13836, 1871190838.53918, 935595419.26959], ["2026-03-21T00:00:00.000Z", 25941, 13836, 1879354822.9548, 939677411.4774], ["2026-03-20T22:00:00.000Z", 25901, 13766, 1929939252.27754, 964969626.13877], ["2026-03-20T20:00:00.000Z", 26219, 13690, 1917041269.429, 958520634.7145], ["2026-03-20T18:00:00.000Z", 26124, 13592, 1877461164.53226, 938730582.26613], ["2026-03-20T16:00:00.000Z", 26033, 13534, 1876110089.48268, 938055044.74134], ["2026-03-20T14:00:00.000Z", 25859, 13539, 1859239618.36568, 929619809.18284], ["2026-03-20T12:00:00.000Z", 25829, 13874, 1860622930.41664, 930311465.20832], ["2026-03-20T10:00:00.000Z", 25681, 13821, 1883874682.8504, 941937341.4252], ["2026-03-20T08:00:00.000Z", 25537, 13789, 1948956732.78244, 974478366.39122], ["2026-03-20T06:00:00.000Z", 25844, 13862, 1957874901.63888, 978937450.81944], ["2026-03-20T04:00:00.000Z", 25614, 13696, 1992332206.79432, 996166103.39716], ["2026-03-20T02:00:00.000Z", 25841, 13683, 1992083915.64992, 996041957.82496], ["2026-03-20T00:00:00.000Z", 25709, 13518, 1986293620.17238, 993146810.08619], ["2026-03-19T22:00:00.000Z", 25758, 13711, 2046705900.73236, 1023352950.36618], ["2026-03-19T20:00:00.000Z", 25556, 13507, 1922864556.96036, 961432278.48018], ["2026-03-19T18:00:00.000Z", 25941, 13097, 1957744308.90106, 978872154.45053], ["2026-03-19T16:00:00.000Z", 25664, 12651, 1961552912.544, 980776456.272], ["2026-03-19T14:00:00.000Z", 25500, 12543, 1981661288.81952, 990830644.40976], ["2026-03-19T12:00:00.000Z", 25829, 12708, 1975288268.89968, 987644134.44984], ["2026-03-19T10:00:00.000Z", 25543, 12614, 1949132465.30288, 974566232.65144], ["2026-03-19T08:00:00.000Z", 24676, 13110, 1929878611.79764, 964939305.89882], ["2026-03-19T06:00:00.000Z", 26282, 14279, 1927560433.23664, 963780216.61832], ["2026-03-19T04:00:00.000Z", 26020, 14180, 1977352916.44608, 988676458.22304], ["2026-03-19T02:00:00.000Z", 26209, 14170, 1967613977.92184, 983806988.96092], ["2026-03-19T00:00:00.000Z", 26071, 14094, 1982363544.3402, 991181772.1701], ["2026-03-18T22:00:00.000Z", 25924, 13908, 1949159023.68618, 974579511.84309], ["2026-03-18T20:00:00.000Z", 25436, 13629, 1923113614.01784, 961556807.00892], ["2026-03-18T18:00:00.000Z", 25856, 14080, 1962638858.74434, 981319429.37217], ["2026-03-18T16:00:00.000Z", 25321, 13462, 1941574171.62672, 970787085.81336], ["2026-03-18T14:00:00.000Z", 26045, 13515, 1883383126.55358, 941691563.27679], ["2026-03-18T12:00:00.000Z", 25720, 13168, 1884526822.57878, 942263411.28939], ["2026-03-18T10:00:00.000Z", 26645, 14010, 1924805991.626, 962402995.813], ["2026-03-18T08:00:00.000Z", 26623, 14017, 1927113655.05464, 963556827.52732], ["2026-03-18T06:00:00.000Z", 26436, 13880, 1942486731.77232, 971243365.88616], ["2026-03-18T04:00:00.000Z", 26433, 13880, 1955320828.01864, 977660414.00932], ["2026-03-18T02:00:00.000Z", 26399, 13831, 1959801132.178, 979900566.089], ["2026-03-18T00:00:00.000Z", 26487, 13881, 1936971916.29216, 968485958.14608], ["2026-03-17T22:00:00.000Z", 26418, 13938, 1938401200.95864, 969200600.47932], ["2026-03-17T20:00:00.000Z", 26544, 14156, 2004384537.9956, 1002192268.9978], ["2026-03-17T18:00:00.000Z", 26174, 13920, 1993191114.36332, 996595557.18166], ["2026-03-17T16:00:00.000Z", 26068, 13842, 1940767087.26762, 970383543.63381], ["2026-03-17T14:00:00.000Z", 25713, 13678, 1895388785.77776, 947694392.88888], ["2026-03-17T12:00:00.000Z", 26023, 13709, 1890131648.6093, 945065824.30465], ["2026-03-17T10:00:00.000Z", 25884, 13675, 1912230958.17348, 956115479.08674], ["2026-03-17T08:00:00.000Z", 25714, 13624, 1919240682.77376, 959620341.38688], ["2026-03-17T06:00:00.000Z", 25351, 13299, 1923352104.71844, 961676052.35922], ["2026-03-17T04:00:00.000Z", 24951, 13297, 1990421272.43232, 995210636.21616], ["2026-03-17T02:00:00.000Z", 25416, 13950, 2031640962.98046, 1015820481.49023], ["2026-03-17T00:00:00.000Z", 26177, 14129, 1995327714.51292, 997663857.25646], ["2026-03-16T22:00:00.000Z", 26072, 13701, 1965875959.3215, 982937979.66075], ["2026-03-16T20:00:00.000Z", 26569, 13659, 1942025453.3178, 971012726.6589], ["2026-03-16T18:00:00.000Z", 26311, 13654, 1982420102.40768, 991210051.20384], ["2026-03-16T16:00:00.000Z", 26201, 13542, 1935930468.0716, 967965234.0358], ["2026-03-16T14:00:00.000Z", 26111, 13537, 1924168422.89232, 962084211.44616], ["2026-03-16T12:00:00.000Z", 26011, 13598, 1924354808.4068, 962177404.2034], ["2026-03-16T10:00:00.000Z", 25703, 13372, 1930530768.47104, 965265384.23552], ["2026-03-16T08:00:00.000Z", 25677, 13335, 1930126026.20628, 965063013.10314], ["2026-03-16T06:00:00.000Z", 25281, 13485, 1957496259.3744, 978748129.6872], ["2026-03-16T04:00:00.000Z", 25096, 13412, 1933700487.4356, 966850243.7178], ["2026-03-16T02:00:00.000Z", 25702, 13789, 1917277043.01364, 958638521.50682], ["2026-03-16T00:00:00.000Z", 25436, 13775, 1901478712.00228, 950739356.00114], ["2026-03-15T22:00:00.000Z", 25787, 13960, 1866741224.9477, 933370612.47385], ["2026-03-15T20:00:00.000Z", 26048, 13980, 1871332105.3478, 935666052.6739], ["2026-03-15T18:00:00.000Z", 26008, 13968, 1902899920.68576, 951449960.34288], ["2026-03-15T16:00:00.000Z", 26086, 13923, 1891984411.7506, 945992205.8753], ["2026-03-15T14:00:00.000Z", 25893, 13845, 1856666865.6582, 928333432.8291], ["2026-03-15T12:00:00.000Z", 25899, 14469, 1880397801.00144, 940198900.50072], ["2026-03-15T10:00:00.000Z", 25836, 14487, 1888721477.55002, 944360738.77501], ["2026-03-15T08:00:00.000Z", 25769, 13901, 1847265945.85146, 923632972.92573], ["2026-03-15T06:00:00.000Z", 25572, 13837, 1852658067.6373, 926329033.81865], ["2026-03-15T04:00:00.000Z", 25626, 13797, 1849858704.27144, 924929352.13572], ["2026-03-15T02:00:00.000Z", 25752, 13718, 1818851543.48598, 909425771.74299], ["2026-03-15T00:00:00.000Z", 25700, 13648, 1820628465.0058, 910314232.5029], ["2026-03-14T22:00:00.000Z", 25867, 13547, 1811290262.90214, 905645131.45107], ["2026-03-14T20:00:00.000Z", 25810, 13495, 1816774568.81338, 908387284.40669], ["2026-03-14T18:00:00.000Z", 25809, 13391, 1818594146.18344, 909297073.09172], ["2026-03-14T16:00:00.000Z", 25758, 13359, 1825696779.984, 912848389.992], ["2026-03-14T14:00:00.000Z", 25574, 13269, 1836989036.22036, 918494518.11018], ["2026-03-14T12:00:00.000Z", 25469, 13161, 1819453305.31524, 909726652.65762], ["2026-03-14T10:00:00.000Z", 25390, 13048, 1816269561.02852, 908134780.51426], ["2026-03-14T08:00:00.000Z", 25168, 12928, 1833445348.19522, 916722674.09761], ["2026-03-14T06:00:00.000Z", 25139, 13034, 1833618104.60738, 916809052.30369], ["2026-03-14T04:00:00.000Z", 25201, 12952, 1847019935.8628, 923509967.9314], ["2026-03-14T02:00:00.000Z", 25153, 12776, 1848258268.61678, 924129134.30839], ["2026-03-14T00:00:00.000Z", 25156, 12807, 1861514009.7194, 930757004.8597], ["2026-03-13T22:00:00.000Z", 24871, 12706, 1908119667.64088, 954059833.82044], ["2026-03-13T20:00:00.000Z", 25235, 12821, 1883072925.92634, 941536462.96317], ["2026-03-13T18:00:00.000Z", 25084, 12684, 1884009667.58152, 942004833.79076], ["2026-03-13T16:00:00.000Z", 25190, 12728, 1905515195.56632, 952757597.78316], ["2026-03-13T14:00:00.000Z", 24777, 13286, 1966190113.3744, 983095056.6872], ["2026-03-13T12:00:00.000Z", 25378, 13667, 1911167407.05688, 955583703.52844], ["2026-03-13T10:00:00.000Z", 25458, 13772, 1922982357.9564, 961491178.9782], ["2026-03-13T08:00:00.000Z", 25578, 13470, 1847935437.91312, 923967718.95656], ["2026-03-13T06:00:00.000Z", 25297, 13017, 1826730338.8877, 913365169.44385], ["2026-03-13T04:00:00.000Z", 25038, 12915, 1820928552.88108, 910464276.44054], ["2026-03-13T02:00:00.000Z", 25065, 12949, 1863097091.939, 931548545.9695], ["2026-03-13T00:00:00.000Z", 24710, 12757, 1899736533.38716, 949868266.69358], ["2026-03-12T22:00:00.000Z", 25411, 12369, 1847649861.40412, 923824930.70206], ["2026-03-12T20:00:00.000Z", 25367, 12343, 1862939888.14944, 931469944.07472], ["2026-03-12T18:00:00.000Z", 25340, 12423, 1910226185.57808, 955113092.78904], ["2026-03-12T16:00:00.000Z", 25139, 12360, 1897145408.29632, 948572704.14816], ["2026-03-12T14:00:00.000Z", 25161, 12442, 1921827603.29268, 960913801.64634], ["2026-03-12T12:00:00.000Z", 25032, 12539, 1897320710.88472, 948660355.44236], ["2026-03-12T10:00:00.000Z", 24986, 12601, 1847451526.28784, 923725763.14392], ["2026-03-12T08:00:00.000Z", 25100, 12990, 1802189119.35576, 901094559.67788], ["2026-03-12T06:00:00.000Z", 25045, 12740, 1814720782.36148, 907360391.18074], ["2026-03-12T04:00:00.000Z", 24971, 12660, 1818627664.2336, 909313832.1168], ["2026-03-12T02:00:00.000Z", 25154, 12637, 1819637721.74864, 909818860.87432], ["2026-03-12T00:00:00.000Z", 24996, 12756, 1816659204.4083, 908329602.20415], ["2026-03-11T22:00:00.000Z", 25218, 13423, 1787795072.9439, 893897536.47195], ["2026-03-11T20:00:00.000Z", 25116, 13366, 1797676946.67416, 898838473.33708], ["2026-03-11T18:00:00.000Z", 25010, 13302, 1859524803.68736, 929762401.84368], ["2026-03-11T16:00:00.000Z", 24972, 12770, 1865524515.77934, 932762257.88967], ["2026-03-11T14:00:00.000Z", 24782, 12826, 1830127078.51766, 915063539.25883], ["2026-03-11T12:00:00.000Z", 25023, 12485, 1759411407.80392, 879705703.90196], ["2026-03-11T10:00:00.000Z", 25344, 12926, 1751408032.85784, 875704016.42892], ["2026-03-11T08:00:00.000Z", 25200, 12901, 1752250812.59316, 876125406.29658], ["2026-03-11T06:00:00.000Z", 24997, 12744, 1750187364.3462, 875093682.1731], ["2026-03-11T04:00:00.000Z", 25086, 12736, 1772448627.49662, 886224313.74831], ["2026-03-11T02:00:00.000Z", 24975, 12738, 1760437173.7956, 880218586.8978], ["2026-03-11T00:00:00.000Z", 24795, 12688, 1778348660.62718, 889174330.31359], ["2026-03-10T22:00:00.000Z", 24634, 12473, 1757688002.016, 878844001.008], ["2026-03-10T20:00:00.000Z", 24634, 12543, 1757515114.66346, 878757557.33173], ["2026-03-10T18:00:00.000Z", 24427, 12362, 1739828178.8553, 869914089.42765], ["2026-03-10T16:00:00.000Z", 24547, 12653, 1835299559.82576, 917649779.91288], ["2026-03-10T14:00:00.000Z", 24441, 12503, 1816165979.95704, 908082989.97852], ["2026-03-10T12:00:00.000Z", 24581, 12795, 1826799300.92032, 913399650.46016], ["2026-03-10T10:00:00.000Z", 24448, 12895, 1738473140.72928, 869236570.36464], ["2026-03-10T09:00:00.000Z", 24300, 12874, 1747578889.29664, 873789444.64832] ] } } ``` {% endcode %}
*** ### Export Position Breakdown by Size `/api/external/exports/coins/{coin}/position-breakdown-by-size`
{% hint style="info" %} This export powers the **Position Breakdown by Size** table on the [Perps](https://app.coinmarketman.com/hypertracker/perps/btc) page in the HyperTracker {% endhint %} {% hint style="success" %} **Unique to HyperTracker Users** Export aggregated open-position size bucket data for any supported coin, based on HyperTracker’s full exchange-wide position tracking. {% endhint %} Returns a `302` redirect to a short-lived pre-signed S3 URL. Follow the redirect to download a JSON export containing the current position breakdown by size for the requested coin. This export buckets all currently open positions for the selected coin into predefined position-size ranges, showing position count, total value, long-side value, directional bias, and value close to liquidation for each bucket. Use this endpoint to rebuild the **Position Breakdown by Size** table shown on the HyperTracker Perps page. The pre-signed URL expires after `120` seconds.
Path Parameters
ParameterTypeDescription
coinstringCoin symbol, case-insensitive. Example: BTC or ETH.
filestringExport file type. Use position-breakdown-by-size.
Request Examples {% tabs %} {% tab title="Curl" %} ``` curl --request GET \ --url 'https://ht-api.coinmarketman.com/api/external/exports/coins/BTC/position-breakdown-by-size' \ --header 'accept: application/json' \ --header 'Authorization: Bearer YOUR_API_TOKEN' \ --location ``` {% endtab %} {% tab title="Python" %} ``` import requests url = "https://ht-api.coinmarketman.com/api/external/exports/coins/BTC/position-breakdown-by-size" headers = { "accept": "application/json", "Authorization": "Bearer YOUR_API_TOKEN" } response = requests.get(url, headers=headers, allow_redirects=True) response.raise_for_status() data = response.json() print(data) ``` {% endtab %} {% endtabs %} Response > 302 Found: Redirects to a temporary pre-signed S3 URL. Follow the redirect to download the export file. > > If your HTTP client does not follow redirects automatically, read the `Location` header and download the file from that URL.
Response Example {% code expandable="true" %} ``` { "coin": "BTC", "createdAt": "2026-04-27T18:00:25.270Z", "breakdownBySize": [ { "sizeSegmentId": 1, "size": "<$1k", "minSize": null, "maxSize": 1000, "positionCount": 16955, "pastPositionCount": 16818, "totalPositionValue": 4053999.39276, "pastTotalPositionValue": 4019817.3536, "totalPositionValueLong": 1972702.88576, "valueCloseToLiquidation": 7825.2742, "bias": 0.487 }, { "sizeSegmentId": 2, "size": "$1k-$10k", "minSize": 1000, "maxSize": 10000, "positionCount": 7673, "pastPositionCount": 7559, "totalPositionValue": 27849542.20272, "pastTotalPositionValue": 27619299.3796, "totalPositionValueLong": 13794701.15132, "valueCloseToLiquidation": 61009.5066, "bias": 0.495 }, { "sizeSegmentId": 3, "size": "$10k-$25k", "minSize": 10000, "maxSize": 25000, "positionCount": 2000, "pastPositionCount": 1999, "totalPositionValue": 32415400.49488, "pastTotalPositionValue": 32310389.2566, "totalPositionValueLong": 16200018.50696, "valueCloseToLiquidation": 125700.23096, "bias": 0.5 }, { "sizeSegmentId": 4, "size": "$25k-$50k", "minSize": 25000, "maxSize": 50000, "positionCount": 1129, "pastPositionCount": 1110, "totalPositionValue": 40348882.23344, "pastTotalPositionValue": 39882936.117, "totalPositionValueLong": 20402340.42656, "valueCloseToLiquidation": 175335.26592, "bias": 0.506 }, { "sizeSegmentId": 5, "size": "$50k-$100k", "minSize": 50000, "maxSize": 100000, "positionCount": 905, "pastPositionCount": 894, "totalPositionValue": 65344709.27436, "pastTotalPositionValue": 64433606.9904, "totalPositionValueLong": 31003338.78432, "valueCloseToLiquidation": 182257.88956, "bias": 0.474 }, { "sizeSegmentId": 6, "size": "$100k-$250k", "minSize": 100000, "maxSize": 250000, "positionCount": 811, "pastPositionCount": 803, "totalPositionValue": 129533483.93456, "pastTotalPositionValue": 128252690.5556, "totalPositionValueLong": 60182718.60016, "valueCloseToLiquidation": 571472.21436, "bias": 0.465 }, { "sizeSegmentId": 7, "size": "$250k-$500k", "minSize": 250000, "maxSize": 500000, "positionCount": 357, "pastPositionCount": 352, "totalPositionValue": 128202214.05448, "pastTotalPositionValue": 126201453.7062, "totalPositionValueLong": 56008588.3918, "valueCloseToLiquidation": 402635.87896, "bias": 0.437 }, { "sizeSegmentId": 8, "size": "$500k-$1m", "minSize": 500000, "maxSize": 1000000, "positionCount": 216, "pastPositionCount": 217, "totalPositionValue": 148842598.6314, "pastTotalPositionValue": 150030640.5228, "totalPositionValueLong": 73449052.1716, "valueCloseToLiquidation": 0, "bias": 0.493 }, { "sizeSegmentId": 9, "size": "$1m-$2.5m", "minSize": 1000000, "maxSize": 2500000, "positionCount": 154, "pastPositionCount": 156, "totalPositionValue": 249121762.02952, "pastTotalPositionValue": 254137649.6188, "totalPositionValueLong": 134236958.05912, "valueCloseToLiquidation": 3186377.96848, "bias": 0.539 }, { "sizeSegmentId": 10, "size": ">$2.5m", "minSize": 2500000, "maxSize": null, "positionCount": 153, "pastPositionCount": 157, "totalPositionValue": 1308896552.26428, "pastTotalPositionValue": 1340705948.1022, "totalPositionValueLong": 660054153.2786, "valueCloseToLiquidation": 0, "bias": 0.504 } ] } ``` {% endcode %}
*** --- # 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/positions-and-market-data.md?ask= ``` 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.