# Leaderboards Access curated, real-time leaderboards across the Hyperliquid ecosystem, ranking wallets and traders by performance, positioning, and activity, as seen in the [Leaderboards](https://app.coinmarketman.com/hypertracker/leaderboards) section of the HyperTracker dashboard. {% hint style="success" %} **Unique to HyperTracker Users** All leaderboards in this section are independently compiled and enriched by HyperTracker using proprietary data pipelines. In addition to full-market coverage, these endpoints include unique metrics not available via the standard Hyperliquid API, such as wallet age, leverage, open exposure, and real-time directional bias offering a significantly deeper and more actionable view of trader performance and positioning. {% endhint %} ### Get All PnL Leaderboard `/api/external/leaderboards/all-pnl`
{% hint style="success" %} **Unique to HyperTracker Users** This leaderboard is independently compiled by HyperTracker from enriched wallet-level portfolio data. It combines portfolio value, asset distribution, stablecoin exposure, top holdings, PnL windows, cohort segments, vault data, and profile metadata into a single ranked view. {% endhint %} Returns the full-market PnL leaderboard shown in the HyperTracker dashboard, ranking Hyperliquid wallets by realised and unrealised portfolio performance. Each row includes the wallet address, wallet age, total portfolio value, stablecoin allocation, top holding, PnL across day/week/month/all-time windows, leaderboard rank, and enriched profile data such as verification status, favourite count, cohort segments, perp PnL, total equity, and vault information where available. Use this endpoint to identify the highest-performing wallets across the Hyperliquid ecosystem, compare rankings across different PnL windows, and analyse how top wallets are positioned by portfolio value, holdings, and profile metadata.
Query Parameters
ParameterTypeRequiredDescription
offsetnumberNoNumber of results to skip before returning results. Use with limit for pagination. Default: 0.
limitnumberNoNumber of wallet entries to return. Allowed values: 25, 50, 100. Default: 25.
orderstringYesSort direction. Allowed values: asc, desc.
orderBystringYesPnL field used to sort the returned results. Allowed values: pnlDay, pnlWeek, pnlMonth, pnlAllTime.
rankBystringYesPnL field used to calculate each wallet’s leaderboard rank. Allowed values: pnlDay, pnlWeek, pnlMonth, pnlAllTime.
Request Examples {% tabs %} {% tab title="Curl" %} ``` curl --request GET \ --url 'https://ht-api.coinmarketman.com/api/external/leaderboards/all-pnl?limit=25&rankBy=pnlAllTime&orderBy=pnlAllTime&order=desc' \ --header 'Authorization: Bearer YOUR_API_TOKEN' ``` {% endtab %} {% tab title="Python" %} ``` import requests response = requests.get( "https://ht-api.coinmarketman.com/api/external/leaderboards/all-pnl", params={ "limit": 25, "rankBy": "pnlAllTime", "orderBy": "pnlAllTime", "order": "desc" }, headers={ "Authorization": "Bearer YOUR_API_TOKEN" }, ) result = response.json() ``` {% endtab %} {% tab title="JavaScript" %} ``` const response = await fetch( 'https://ht-api.coinmarketman.com/api/external/leaderboards/all-pnl?limit=25&rankBy=pnlAllTime&orderBy=pnlAllTime&order=desc', { headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' } } ); const leaderboard = await response.json(); ``` {% endtab %} {% endtabs %} Response > 200 Success: Returns aggregate leaderboard stats, asset distribution data, total summed PnL, and a paginated ranked list of wallet entries.
Response Example {% code expandable="true" %} ``` { "totalCount": 723068, "assetsDistribution": [ { "coin": "HYPE", "value": 3061963082.11385 }, { "coin": "USDC", "value": 488975051.057732 }, { "coin": "UBTC", "value": 18212596.575859 }, { "coin": "PURR", "value": 9765367.018207 }, { "coin": "UETH", "value": 8648413.256603 }, { "coin": "UXPL", "value": 2698659.779373 }, { "coin": "UENA", "value": 552614.663674 }, { "coin": "USOL", "value": 510673.751313 }, { "coin": "UPUMP", "value": 385278.455804 }, { "coin": "UZEC", "value": 325085.895729 } ], "sumPnl": 7627289223.220724, "data": [ { "address": "0xd57ecca444a9acb7208d286be439de12dd09de5d", "age": "2024-12-04T22:42:00.059Z", "totalValue": 2342027101.860381, "stableValue": 0.970469, "topHolding": "HYPE", "pnlDay": -87983869.070512, "pnlWeek": -36078890.299925, "pnlMonth": 776678544.497826, "pnlAllTime": 2391377745.438558, "rank": 1, "profile": { "mid": null, "cmmId": null, "xUserId": null, "displayName": null, "emoji": null, "verified": false, "segments": [16, 12], "address": "0xd57ecca444a9acb7208d286be439de12dd09de5d", "favoriteCount": 3, "earliestActivityAt": "2024-12-04T22:42:00.059Z", "totalEquity": 2343736270.968558, "perpPnl": -4, "vault": null } }, { "address": "0x77c3ea550d2da44b120e55071f57a108f8dd5e45", "age": "2025-02-19T21:40:00.007Z", "totalValue": 153.044097, "stableValue": 1.666793, "topHolding": "BRIDGE", "pnlDay": -0.000045, "pnlWeek": 19.997752, "pnlMonth": 29.593955, "pnlAllTime": 295246409.514539, "rank": 2, "profile": { "mid": null, "cmmId": null, "xUserId": null, "displayName": null, "emoji": null, "verified": false, "segments": [16, 12], "address": "0x77c3ea550d2da44b120e55071f57a108f8dd5e45", "favoriteCount": 1, "earliestActivityAt": "2025-02-19T21:40:00.007Z", "totalEquity": 146.256023, "perpPnl": -1, "vault": null } }, { "address": "0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00", "age": "2024-01-24T22:45:00.027Z", "totalValue": 87115207.710473, "stableValue": 52907104.109593, "topHolding": "USDC", "pnlDay": 1111893.478242, "pnlWeek": 1796447.102973, "pnlMonth": 4952399.424842, "pnlAllTime": 202576980.884517, "rank": 3, "profile": { "mid": null, "cmmId": null, "xUserId": null, "displayName": null, "emoji": null, "verified": false, "segments": [7, 8], "address": "0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00", "favoriteCount": 155, "earliestActivityAt": "2024-01-24T22:45:00.027Z", "totalEquity": 87044751.911767, "perpPnl": 183659065.469617, "vault": null } }, { "address": "0x5b5d51203a0f9079f8aeb098a6523a13f298c060", "age": "2025-02-26T22:26:00.037Z", "totalValue": 23244224.232419, "stableValue": 18864257.483483, "topHolding": "USDC", "pnlDay": -1700993.998958, "pnlWeek": 2148233.653541, "pnlMonth": 1799798.160669, "pnlAllTime": 167977507.59413, "rank": 4, "profile": { "mid": null, "cmmId": null, "xUserId": null, "displayName": null, "emoji": null, "verified": false, "segments": [7, 8], "address": "0x5b5d51203a0f9079f8aeb098a6523a13f298c060", "favoriteCount": 245, "earliestActivityAt": "2025-02-26T22:26:00.037Z", "totalEquity": 23625489.97413, "perpPnl": 178558919.132338, "vault": null } }, { "address": "0x7fdafde5cfb5465924316eced2d3715494c517d1", "age": "2024-10-02T21:22:00.109Z", "totalValue": 30156844.713007, "stableValue": 19497127.480337, "topHolding": "USDC", "pnlDay": 2348752.863942, "pnlWeek": 1857108.047732, "pnlMonth": -8513168.002131, "pnlAllTime": 161592900.871549, "rank": 5, "profile": { "mid": null, "cmmId": null, "xUserId": null, "displayName": null, "emoji": null, "verified": false, "segments": [7, 8], "address": "0x7fdafde5cfb5465924316eced2d3715494c517d1", "favoriteCount": 94, "earliestActivityAt": "2024-10-02T21:22:00.109Z", "totalEquity": 30219616.256776, "perpPnl": 152675234.953364, "vault": null } }, { "address": "0xfae95f601f3a25ace60d19dbb929f2a5c57e3571", "age": "2024-05-29T21:42:00.106Z", "totalValue": 7525283.932791, "stableValue": 2657461.944889, "topHolding": "HFUN", "pnlDay": -42220.941408, "pnlWeek": -28024.451936, "pnlMonth": -387104.086914, "pnlAllTime": 150848566.340201, "rank": 6, "profile": { "mid": null, "cmmId": null, "xUserId": null, "displayName": null, "emoji": null, "verified": false, "segments": [6, 12], "address": "0xfae95f601f3a25ace60d19dbb929f2a5c57e3571", "favoriteCount": 3, "earliestActivityAt": "2024-05-29T21:42:00.106Z", "totalEquity": 7525283.932778, "perpPnl": -0.991382, "vault": null } }, { "address": "0x9794bbbc222b6b93c1417d01aa1ff06d42e5333b", "age": "2024-10-16T21:02:00.013Z", "totalValue": 1877.39417, "stableValue": 1.152155, "topHolding": "HYPE", "pnlDay": -60.706184, "pnlWeek": -24.454419, "pnlMonth": 486.338884, "pnlAllTime": 144134883.965058, "rank": 7, "profile": { "mid": null, "cmmId": null, "xUserId": null, "displayName": null, "emoji": null, "verified": false, "segments": [16, 11], "address": "0x9794bbbc222b6b93c1417d01aa1ff06d42e5333b", "favoriteCount": 1, "earliestActivityAt": "2024-10-16T21:02:00.013Z", "totalEquity": 1872.368507, "perpPnl": 0, "vault": null } }, { "address": "0xa20fcfa0507fe762011962cc581b95bbbc3bbdba", "age": "2024-12-04T21:58:00.087Z", "totalValue": 120364329.166572, "stableValue": 0.015559, "topHolding": "HYPE", "pnlDay": -4484773.362672, "pnlWeek": -2381183.430399, "pnlMonth": 39107543.531865, "pnlAllTime": 120615470.222905, "rank": 8, "profile": { "mid": null, "cmmId": null, "xUserId": null, "displayName": null, "emoji": null, "verified": false, "segments": [16, 11], "address": "0xa20fcfa0507fe762011962cc581b95bbbc3bbdba", "favoriteCount": 1, "earliestActivityAt": "2024-12-04T21:58:00.087Z", "totalEquity": 120615582.332905, "perpPnl": 0, "vault": null } }, { "address": "0xb83de012dba672c76a7dbbbf3e459cb59d7d6e36", "age": "2025-02-26T22:50:00.204Z", "totalValue": 38863829.202355, "stableValue": 34364669.987056, "topHolding": "USDC", "pnlDay": -1425394.297537, "pnlWeek": 3975675.865536, "pnlMonth": 6445538.338517, "pnlAllTime": 120004446.281806, "rank": 9, "profile": { "mid": null, "cmmId": null, "xUserId": null, "displayName": null, "emoji": null, "verified": false, "segments": [7, 8], "address": "0xb83de012dba672c76a7dbbbf3e459cb59d7d6e36", "favoriteCount": 55, "earliestActivityAt": "2025-02-26T22:50:00.204Z", "totalEquity": 39455924.271806, "perpPnl": 126702746.579282, "vault": null } }, { "address": "0x880ac484a1743862989a441d6d867238c7aa311c", "age": "2024-10-23T22:40:00.035Z", "totalValue": 30035649.45195, "stableValue": 8957538.3456, "topHolding": "HYPE", "pnlDay": 171227.408897, "pnlWeek": 115038.937627, "pnlMonth": 3334968.21021, "pnlAllTime": 113482616.91221, "rank": 10, "profile": { "mid": null, "cmmId": null, "xUserId": null, "displayName": null, "emoji": null, "verified": false, "segments": [7, 8], "address": "0x880ac484a1743862989a441d6d867238c7aa311c", "favoriteCount": 21, "earliestActivityAt": "2024-10-23T22:40:00.035Z", "totalEquity": 30027790.44221, "perpPnl": 113440797.711855, "vault": null } }, { "address": "0x2ea18c23f72a4b6172c55b411823cdc5335923f4", "age": "2025-08-20T21:24:00.061Z", "totalValue": 2.700321, "stableValue": 0.141667, "topHolding": "PIP", "pnlDay": -0.237038, "pnlWeek": -0.08784, "pnlMonth": 0.792459, "pnlAllTime": 104557457.961721, "rank": 11, "profile": { "mid": null, "cmmId": null, "xUserId": null, "displayName": null, "emoji": null, "verified": false, "segments": [16, 8], "address": "0x2ea18c23f72a4b6172c55b411823cdc5335923f4", "favoriteCount": 24, "earliestActivityAt": "2025-08-20T21:24:00.061Z", "totalEquity": 2.700189, "perpPnl": 106341324.52, "vault": null } }, { "address": "0x20c2d95a3dfdca9e9ad12794d5fa6fad99da44f5", "age": "2024-09-25T20:44:00.157Z", "totalValue": 3365322.080727, "stableValue": 2967477.106437, "topHolding": "USDC", "pnlDay": 393683.277525, "pnlWeek": 335260.937242, "pnlMonth": -1960488.684943, "pnlAllTime": 103515807.713502, "rank": 12, "profile": { "mid": null, "cmmId": null, "xUserId": null, "displayName": null, "emoji": null, "verified": false, "segments": [6, 8], "address": "0x20c2d95a3dfdca9e9ad12794d5fa6fad99da44f5", "favoriteCount": 17, "earliestActivityAt": "2024-09-25T20:44:00.157Z", "totalEquity": 3375598.852896, "perpPnl": 103304353.56952, "vault": null } }, { "address": "0xa312114b5795dff9b8db50474dd57701aa78ad1e", "age": "2024-11-13T22:28:00.056Z", "totalValue": 7164707.772175, "stableValue": 3776578.178092, "topHolding": "USDC", "pnlDay": -77765.807606, "pnlWeek": 84857.69428, "pnlMonth": -670753.619942, "pnlAllTime": 93839318.380061, "rank": 14, "profile": { "mid": null, "cmmId": null, "xUserId": null, "displayName": null, "emoji": null, "verified": false, "segments": [6, 8], "address": "0xa312114b5795dff9b8db50474dd57701aa78ad1e", "favoriteCount": 39, "earliestActivityAt": "2024-11-13T22:28:00.056Z", "totalEquity": 7186739.050061, "perpPnl": 88718067.158627, "vault": null } }, { "address": "0x716bd8d3337972db99995dda5c4b34d954a61d95", "age": "2025-01-15T21:50:00.164Z", "totalValue": 51077267.283525, "stableValue": 8.003821, "topHolding": "HYPE", "pnlDay": -1993920.771737, "pnlWeek": -983119.206552, "pnlMonth": 18424372.694781, "pnlAllTime": 92314722.055921, "rank": 15, "profile": { "mid": null, "cmmId": null, "xUserId": null, "displayName": null, "emoji": null, "verified": false, "segments": [16, 11], "address": "0x716bd8d3337972db99995dda5c4b34d954a61d95", "favoriteCount": 0, "earliestActivityAt": "2025-01-15T21:50:00.164Z", "totalEquity": 51145956.465921, "perpPnl": 0, "vault": null } }, { "address": "0x45d26f28196d226497130c4bac709d808fed4029", "age": "2024-01-03T22:45:00.064Z", "totalValue": 25128741.332881, "stableValue": 21094039.531004, "topHolding": "USDC", "pnlDay": 756512.224392, "pnlWeek": 1066205.649555, "pnlMonth": -6222445.971123, "pnlAllTime": 81289040.344558, "rank": 17, "profile": { "mid": null, "cmmId": null, "xUserId": null, "displayName": null, "emoji": null, "verified": false, "segments": [7, 8], "address": "0x45d26f28196d226497130c4bac709d808fed4029", "favoriteCount": 52, "earliestActivityAt": "2024-01-03T22:45:00.064Z", "totalEquity": 25198736.27031, "perpPnl": 77507675.390075, "vault": null } }, { "address": "0xbdfa4f4492dd7b7cf211209c4791af8d52bf5c50", "age": "2023-09-13T22:45:00.024Z", "totalValue": 40295548.659572, "stableValue": 210313.884712, "topHolding": "HYPE", "pnlDay": -1396791.514772, "pnlWeek": -2617396.341152, "pnlMonth": 14771321.072527, "pnlAllTime": 74277259.928801, "rank": 18, "profile": { "mid": null, "cmmId": null, "xUserId": null, "displayName": null, "emoji": null, "verified": false, "segments": [4, 14], "address": "0xbdfa4f4492dd7b7cf211209c4791af8d52bf5c50", "favoriteCount": 1, "earliestActivityAt": "2023-09-13T22:45:00.024Z", "totalEquity": 40417662.558801, "perpPnl": -533143.806214, "vault": null } }, { "address": "0x36715f6408819492c27c1a1538156af9a2bfe963", "age": "2023-08-16T22:45:00.015Z", "totalValue": 6446216.30663, "stableValue": 6441719.510384, "topHolding": "USDC", "pnlDay": -235.4, "pnlWeek": -2168.243981, "pnlMonth": 225.294208, "pnlAllTime": 71886035.196938, "rank": 19, "profile": { "mid": null, "cmmId": null, "xUserId": null, "displayName": null, "emoji": null, "verified": false, "segments": [7, 8], "address": "0x36715f6408819492c27c1a1538156af9a2bfe963", "favoriteCount": 3, "earliestActivityAt": "2023-08-16T22:45:00.015Z", "totalEquity": 6446231.796938, "perpPnl": 70121491.383076, "vault": null } }, { "address": "0x51156f7002c4f74f4956c9e0f2b7bfb6e9dbfac2", "age": "2024-11-13T22:50:00.002Z", "totalValue": 232229.990802, "stableValue": 1730.511805, "topHolding": "PURR", "pnlDay": -7606.469828, "pnlWeek": -17404.431705, "pnlMonth": 40776.85585, "pnlAllTime": 71755816.755194, "rank": 20, "profile": { "mid": null, "cmmId": null, "xUserId": null, "displayName": null, "emoji": null, "verified": false, "segments": [16, 14], "address": "0x51156f7002c4f74f4956c9e0f2b7bfb6e9dbfac2", "favoriteCount": 1, "earliestActivityAt": "2024-11-13T22:50:00.002Z", "totalEquity": 232546.055194, "perpPnl": -636618.84, "vault": null } } ] } ``` {% endcode %}
*** ### Get Perp PnL Leaderboard `/api/external/leaderboards/perp-pnl`
{% hint style="success" %} **Unique to HyperTracker Users** This leaderboard is independently compiled by HyperTracker. It combines enriched wallet-level perp metrics including perp equity, open notional value, leverage, directional bias, PnL, PnL percentages, and trading volume across multiple timeframes. {% endhint %} Returns the perp-only PnL leaderboard shown in the HyperTracker dashboard, ranking Hyperliquid wallets by perp trading performance. Each row includes the wallet address, wallet age, perp equity, open notional value, long-side open value, exposure ratio, directional bias, PnL across day/week/month/all-time windows, trading volume across the same periods, and the computed leaderboard rank. Use this endpoint to identify the strongest perp traders, compare short-term and long-term perp performance, analyse wallet exposure, and understand how top-ranked traders are currently positioned.
Query Parameters
ParameterTypeDescription
offsetnumberNumber of rows to skip before returning results. Use with limit for pagination.
limitnumberNumber of wallet entries to return. Allowed values: 25, 50, 100. Default: 25.
orderstringSort direction. Allowed values: asc, desc. Default: desc.
orderBystringPnL field used to sort the returned results. Allowed values: pnlDay, pnlWeek, pnlMonth, pnlAllTime. Default: pnlAllTime.
rankBystringPnL field used to calculate each wallet’s leaderboard rank. Allowed values: pnlDay, pnlWeek, pnlMonth, pnlAllTime. Default: pnlAllTime.
Request Examples {% tabs %} {% tab title="Curl" %} ``` curl --request GET \ --url 'https://ht-api.coinmarketman.com/api/external/leaderboards/perp-pnl?limit=25&rankBy=pnlAllTime&orderBy=pnlAllTime&order=desc' \ --header 'Authorization: Bearer YOUR_API_TOKEN' ``` {% endtab %} {% tab title="JavaScript" %} ``` const response = await fetch( 'https://ht-api.coinmarketman.com/api/external/leaderboards/perp-pnl?limit=25&rankBy=pnlAllTime&orderBy=pnlAllTime&order=desc', { headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' } } ); const leaderboard = await response.json(); ``` {% endtab %} {% tab title="Python" %} ``` import requests response = requests.get( "https://ht-api.coinmarketman.com/api/external/leaderboards/perp-pnl", params={ "limit": 25, "rankBy": "pnlAllTime", "orderBy": "pnlAllTime", "order": "desc" }, headers={ "Authorization": "Bearer YOUR_API_TOKEN" }, ) result = response.json() ``` {% endtab %} {% endtabs %} Response > 200 Success: Returns the total number of eligible perp leaderboard wallets and a paginated list of ranked wallet entries, including perp equity, open exposure, directional bias, PnL, PnL percentage, and trading volume across multiple timeframes.
Response Example {% code expandable="true" %} ``` { "totalCount": 358873, "data": [ { "address": "0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00", "age": "2024-01-24T22:45:00.027Z", "perpEquity": 38798460.422645, "openValue": 83947649.191818, "openValueLong": 10828661.43778, "exposureRatio": 2.1636850606273375, "bias": -1.6054844866963278, "pnlDay": -1918909.99648, "pnlWeek": 3877662.489589, "pnlMonth": -2411215.951748, "pnlAllTime": 181411732.02535, "rank": 1, "volumeDay": 299127989.07, "volumeWeek": 2062768966.28, "volumeMonth": 9677963348.36, "volumeAllTime": 215586752745.87, "pnlPercentDay": -4.955069021910244, "pnlPercentWeek": 10.84645570300284, "pnlPercentMonth": -5.044978956565576, "pnlPercentAllTime": 227.20428149272612 }, { "address": "0x5b5d51203a0f9079f8aeb098a6523a13f298c060", "age": "2025-02-26T22:26:00.037Z", "perpEquity": 23154492.60776, "openValue": 37715580.043569, "openValueLong": 3034446.1312, "exposureRatio": 1.6288666170524935, "bias": -1.3667623090372933, "pnlDay": 676910.490449, "pnlWeek": 3838560.110105, "pnlMonth": 2331584.292802, "pnlAllTime": 180248939.060521, "rank": 2, "volumeDay": 2028237.16, "volumeWeek": 48764819.41, "volumeMonth": 84674554.36, "volumeAllTime": 3717674924.51, "pnlPercentDay": 2.9877779744647266, "pnlPercentWeek": 19.520082468654515, "pnlPercentMonth": 11.10208984959774, "pnlPercentAllTime": 500.2788069651402 }, { "address": "0x7fdafde5cfb5465924316eced2d3715494c517d1", "age": "2024-10-02T21:22:00.109Z", "perpEquity": 14965108.321596, "openValue": 82996013.01115, "openValueLong": 13469664.823493, "exposureRatio": 5.545968076380662, "bias": -3.74582543336951, "pnlDay": -1524424.75835, "pnlWeek": 2162202.099649, "pnlMonth": -8179819.004859, "pnlAllTime": 149501981.119722, "rank": 3, "volumeDay": 5834120.3, "volumeWeek": 32127267.38, "volumeMonth": 217436640.06, "volumeAllTime": 10474490313.93, "pnlPercentDay": -9.340755950762091, "pnlPercentWeek": 12.402595354388014, "pnlPercentMonth": -26.63447877065345, "pnlPercentAllTime": 163.82938030652346 }, { "address": "0xb83de012dba672c76a7dbbbf3e459cb59d7d6e36", "age": "2025-02-26T22:50:00.204Z", "perpEquity": 33070922.527995, "openValue": 72966025.794924, "openValueLong": 9161955.33983, "exposureRatio": 2.206349875276604, "bias": -1.652270663723054, "pnlDay": 280592.019269, "pnlWeek": 6246338.032488, "pnlMonth": 6373558.572962, "pnlAllTime": 127826368.424635, "rank": 4, "volumeDay": 25428774.35, "volumeWeek": 97856370.04, "volumeMonth": 189921902.99, "volumeAllTime": 3487973377.04, "pnlPercentDay": 0.8164849882709834, "pnlPercentWeek": 21.994066244147778, "pnlPercentMonth": 22.89738067690125, "pnlPercentAllTime": 678.3130763553421 }, { "address": "0x880ac484a1743862989a441d6d867238c7aa311c", "age": "2024-10-23T22:40:00.035Z", "perpEquity": 6482857.925577, "openValue": 30370525.770928, "openValueLong": 70336.50676, "exposureRatio": 4.684743383177706, "bias": -4.663044154976977, "pnlDay": -1358113.092967, "pnlWeek": 62330.202835, "pnlMonth": -2798483.737925, "pnlAllTime": 112163270.360279, "rank": 5, "volumeDay": 3387755.85, "volumeWeek": 24662281.63, "volumeMonth": 127918472.35, "volumeAllTime": 6154115643.74, "pnlPercentDay": -18.870775959625384, "pnlPercentWeek": 0.7765346684765049, "pnlPercentMonth": -34.76866169200855, "pnlPercentAllTime": 166.6558058590195 }, { "address": "0x2ea18c23f72a4b6172c55b411823cdc5335923f4", "age": "2025-08-20T21:24:00.061Z", "perpEquity": 0, "openValue": 0, "openValueLong": 0, "exposureRatio": null, "bias": null, "pnlDay": 0, "pnlWeek": 0, "pnlMonth": 0, "pnlAllTime": 106341324.52, "rank": 6, "volumeDay": 0, "volumeWeek": 0, "volumeMonth": 0, "volumeAllTime": 1472005859.76, "pnlPercentDay": 0, "pnlPercentWeek": 0, "pnlPercentMonth": 0, "pnlPercentAllTime": 118.60044441682503 }, { "address": "0x20c2d95a3dfdca9e9ad12794d5fa6fad99da44f5", "age": "2024-09-25T20:44:00.157Z", "perpEquity": 2499674.510025, "openValue": 8972636.08745, "openValueLong": 0, "exposureRatio": 3.5895217763212948, "bias": -3.5895217763212948, "pnlDay": -125970.281332, "pnlWeek": 519529.841262, "pnlMonth": -1406095.797027, "pnlAllTime": 102850482.29465, "rank": 7, "volumeDay": 0, "volumeWeek": 0, "volumeMonth": 18208731.13, "volumeAllTime": 1073018469.66, "pnlPercentDay": -4.534366599438743, "pnlPercentWeek": 11.326793751146381, "pnlPercentMonth": -17.907147647273018, "pnlPercentAllTime": 7163.428565356759 }, { "address": "0xa312114b5795dff9b8db50474dd57701aa78ad1e", "age": "2024-11-13T22:28:00.056Z", "perpEquity": 3684384.226272, "openValue": 5359836.6821, "openValueLong": 0, "exposureRatio": 1.4547442266962711, "bias": -1.4547442266962711, "pnlDay": -195333.551627, "pnlWeek": 166620.596254, "pnlMonth": -1341242.161095, "pnlAllTime": 88631047.336328, "rank": 8, "volumeDay": 217592.31, "volumeWeek": 3808712.2, "volumeMonth": 52312476.51, "volumeAllTime": 976829836.69, "pnlPercentDay": -4.785295306131522, "pnlPercentWeek": 4.20115315857798, "pnlPercentMonth": -32.71371857422772, "pnlPercentAllTime": 142.3998529230119 }, { "address": "0x45d26f28196d226497130c4bac709d808fed4029", "age": "2024-01-03T22:45:00.064Z", "perpEquity": 19776905.526983, "openValue": 47089677.1341, "openValueLong": 6076060.5, "exposureRatio": 2.3810437416436203, "bias": -1.7665835581017604, "pnlDay": -1283041.970487, "pnlWeek": 1472655.391977, "pnlMonth": -6766652.588933, "pnlAllTime": 76311998.533068, "rank": 9, "volumeDay": 0, "volumeWeek": 3972549.16, "volumeMonth": 22160608.44, "volumeAllTime": 614364306.4, "pnlPercentDay": -5.962158503139352, "pnlPercentWeek": 7.124748770812419, "pnlPercentMonth": -29.876920428894877, "pnlPercentAllTime": 332.78192015376175 }, { "address": "0x36715f6408819492c27c1a1538156af9a2bfe963", "age": "2023-08-16T22:45:00.015Z", "perpEquity": 6441719.482186, "openValue": 0, "openValueLong": 0, "exposureRatio": 0, "bias": null, "pnlDay": 0, "pnlWeek": 0, "pnlMonth": 0, "pnlAllTime": 70121491.383076, "rank": 10, "volumeDay": 0, "volumeWeek": 0, "volumeMonth": 0, "volumeAllTime": 0, "pnlPercentDay": 0, "pnlPercentWeek": 0, "pnlPercentMonth": 0, "pnlPercentAllTime": 295.5929124913098 }, { "address": "0xd47587702a91731dc1089b5db0932cf820151a91", "age": "2025-01-22T20:50:00.102Z", "perpEquity": 29730529.852373, "openValue": 43733682.636046, "openValueLong": 4269079.03557, "exposureRatio": 1.4710024628960763, "bias": -1.1838176022986957, "pnlDay": -1067919.484445, "pnlWeek": 5063958.50611, "pnlMonth": -3346094.940173, "pnlAllTime": 68043546.574948, "rank": 11, "volumeDay": 7256729.68, "volumeWeek": 50452718.77, "volumeMonth": 187067550.74, "volumeAllTime": 3521424232.67, "pnlPercentDay": -3.400264925413174, "pnlPercentWeek": 17.801542806143335, "pnlPercentMonth": -9.007108139365075, "pnlPercentAllTime": 892.1161988043968 }, { "address": "0x023a3d058020fb76cca98f01b3c48c8938a22355", "age": "2024-05-29T21:18:00.151Z", "perpEquity": 15564932.083082, "openValue": 69149715.643033, "openValueLong": 37152778.006189, "exposureRatio": 4.442660929962806, "bias": 0.331247212761631, "pnlDay": -1217313.973617, "pnlWeek": 70055.908972, "pnlMonth": 3516281.438604, "pnlAllTime": 65362088.92388, "rank": 12, "volumeDay": 72816929.1, "volumeWeek": 400572403.72, "volumeMonth": 2508446823.96, "volumeAllTime": 223135620407.87, "pnlPercentDay": -6.056634091774036, "pnlPercentWeek": 0.3457170074411538, "pnlPercentMonth": 21.240095450912463, "pnlPercentAllTime": 197.19846377995364 }, { "address": "0x5d2f4460ac3514ada79f5d9838916e508ab39bb7", "age": "2024-12-25T21:34:00.103Z", "perpEquity": 5872286.295759, "openValue": 14076751.3854, "openValueLong": 14076751.3854, "exposureRatio": 2.39715004964358, "bias": 2.39715004964358, "pnlDay": 79967.545807, "pnlWeek": -74997.402747, "pnlMonth": -82207.573249, "pnlAllTime": 61370634.619458, "rank": 13, "volumeDay": 0, "volumeWeek": 9704098.01, "volumeMonth": 9704098.01, "volumeAllTime": 1602898621.64, "pnlPercentDay": 1.373569827981731, "pnlPercentWeek": -1.2547998336280526, "pnlPercentMonth": -1.3567373624128214, "pnlPercentAllTime": 145.97547427245865 }, { "address": "0x8e096995c3e4a3f0bc5b3ea1cba94de2aa4d70c9", "age": "2024-12-11T22:32:00.009Z", "perpEquity": 2422300.783733, "openValue": 21189788.453388, "openValueLong": 2340318.610739, "exposureRatio": 8.747794078955168, "bias": -6.815483586009414, "pnlDay": -46755.635823, "pnlWeek": 1449950.590472, "pnlMonth": -1436752.246249, "pnlAllTime": 59289233.945135, "rank": 14, "volumeDay": 0, "volumeWeek": 7048593.39, "volumeMonth": 28480703.75, "volumeAllTime": 1354915294.93, "pnlPercentDay": -1.6947934991282128, "pnlPercentWeek": 26.582157326356366, "pnlPercentMonth": -7.730641195603681, "pnlPercentAllTime": 153.70742033812627 }, { "address": "0x35d1151ef1aab579cbb3109e69fa82f94ff5acb1", "age": "2025-07-23T22:48:00.044Z", "perpEquity": 21838100.050694, "openValue": 25223608.646429, "openValueLong": 0, "exposureRatio": 1.155027616316256, "bias": -1.155027616316256, "pnlDay": -584579.010058, "pnlWeek": 1029237.871269, "pnlMonth": -1752561.712139, "pnlAllTime": 57532688.091381, "rank": 15, "volumeDay": 381135.8, "volumeWeek": 5315094.93, "volumeMonth": 24107356.69, "volumeAllTime": 581155707.59, "pnlPercentDay": -2.5544070595771378, "pnlPercentWeek": 4.6264075278076975, "pnlPercentMonth": -7.529395914287057, "pnlPercentAllTime": 184.74302700216668 }, { "address": "0x8af700ba841f30e0a3fcb0ee4c4a9d223e1efa05", "age": "2024-02-28T22:30:00.018Z", "perpEquity": 11777346.609485, "openValue": 79293185.420748, "openValueLong": 73059851.30946, "exposureRatio": 6.732686746001724, "bias": 5.6741572965469675, "pnlDay": 580247.067119, "pnlWeek": -641989.70222, "pnlMonth": -1900133.203077, "pnlAllTime": 51811486.707087, "rank": 16, "volumeDay": 343997.01, "volumeWeek": 75618180.79, "volumeMonth": 185816254.8, "volumeAllTime": 4414115213.22, "pnlPercentDay": 5.13351897022668, "pnlPercentWeek": -5.181522659542631, "pnlPercentMonth": -14.391956182664536, "pnlPercentAllTime": 208.56537573015913 }, { "address": "0xcac19662ec88d23fa1c81ac0e8570b0cf2ff26b3", "age": "2025-05-14T20:56:00.103Z", "perpEquity": 8355416.900517, "openValue": 19637253.483979, "openValueLong": 96282.570399, "exposureRatio": 2.35024221026768, "bias": -2.3271954678859696, "pnlDay": -500572.893358, "pnlWeek": 1336770.987319, "pnlMonth": -4184991.416103, "pnlAllTime": 44605621.109965, "rank": 17, "volumeDay": 0, "volumeWeek": 17684133.64, "volumeMonth": 35244760.17, "volumeAllTime": 344973152.46, "pnlPercentDay": -5.446669621128276, "pnlPercentWeek": 15.672841243446467, "pnlPercentMonth": -29.214862139744046, "pnlPercentAllTime": 129.56616532849392 }, { "address": "0x856c35038594767646266bc7fd68dc26480e910d", "age": "2024-12-11T22:40:00.001Z", "perpEquity": 17827118.358992, "openValue": 36699272.035924, "openValueLong": 15893332.172661, "exposureRatio": 2.0586205407343856, "bias": -0.27556936525998216, "pnlDay": -570899.448641, "pnlWeek": 674715.578601, "pnlMonth": -2391557.035712, "pnlAllTime": 40719486.4999, "rank": 18, "volumeDay": 33081851.45, "volumeWeek": 137094118.65, "volumeMonth": 370175166.94, "volumeAllTime": 3611906032.03, "pnlPercentDay": -3.0786293933162012, "pnlPercentWeek": 3.7494812609902484, "pnlPercentMonth": -12.92449932243222, "pnlPercentAllTime": 2207.415698542734 }, { "address": "0x56498e5f90c14060499b62b6f459b3e3fb9280c5", "age": "2024-12-18T22:54:00.000Z", "perpEquity": 1219.698679, "openValue": 0, "openValueLong": 0, "exposureRatio": 0, "bias": null, "pnlDay": 0, "pnlWeek": 0, "pnlMonth": 0, "pnlAllTime": 38633536.968679, "rank": 19, "volumeDay": 0, "volumeWeek": 0, "volumeMonth": 0, "volumeAllTime": 2395764121.4, "pnlPercentDay": 0, "pnlPercentWeek": 0, "pnlPercentMonth": 0, "pnlPercentAllTime": 191.68549420713123 }, { "address": "0x939f95036d2e7b6d7419ec072bf9d967352204d2", "age": "2025-07-16T21:40:00.066Z", "perpEquity": 10759893.893662, "openValue": 51467959.8034, "openValueLong": 30320327.05856, "exposureRatio": 4.783314808867832, "bias": 0.8524892907283294, "pnlDay": -1154674.204359, "pnlWeek": -784227.183837, "pnlMonth": -261220.162453, "pnlAllTime": 37270422.873314, "rank": 20, "volumeDay": 0, "volumeWeek": 5900552.41, "volumeMonth": 126410064.68, "volumeAllTime": 2051968625.48, "pnlPercentDay": -9.590710198363922, "pnlPercentWeek": -6.311189333998973, "pnlPercentMonth": -2.1240835985658046, "pnlPercentAllTime": 205.02692367915384 }, { "address": "0x4f7634c03ec4e87e14725c84913ade523c6fad5a", "age": "2025-06-18T21:48:00.042Z", "perpEquity": 0, "openValue": 0, "openValueLong": 0, "exposureRatio": null, "bias": null, "pnlDay": 0, "pnlWeek": 0, "pnlMonth": 0, "pnlAllTime": 37080275.97, "rank": 21, "volumeDay": 0, "volumeWeek": 0, "volumeMonth": 0, "volumeAllTime": 213468293.66, "pnlPercentDay": 0, "pnlPercentWeek": 0, "pnlPercentMonth": 0, "pnlPercentAllTime": 335.68875842326247 }, { "address": "0x418aa6bf98a2b2bc93779f810330d88cde488888", "age": "2025-07-23T22:16:24.199Z", "perpEquity": 6131339.104382, "openValue": 33212942.361203, "openValueLong": 0, "exposureRatio": 5.416914934205169, "bias": -5.416914934205169, "pnlDay": -378694.33919, "pnlWeek": 1484004.337729, "pnlMonth": -1808181.335323, "pnlAllTime": 34731528.360111, "rank": 22, "volumeDay": 0, "volumeWeek": 14448603.9, "volumeMonth": 76238599.79, "volumeAllTime": 696781844.33, "pnlPercentDay": -5.213778993225122, "pnlPercentWeek": 16.77793796786672, "pnlPercentMonth": -17.574649622899816, "pnlPercentAllTime": 149.5738470626225 }, { "address": "0xa87a233e8a7d8951ff790a2e39738086cb5f71b7", "age": "2024-01-24T22:45:00.027Z", "perpEquity": 7203906.562121, "openValue": 9962021.860782, "openValueLong": 0, "exposureRatio": 1.3828638357365015, "bias": -1.3828638357365015, "pnlDay": -394439.944494, "pnlWeek": 207191.737019, "pnlMonth": -2710503.141917, "pnlAllTime": 28957720.258967, "rank": 23, "volumeDay": 0, "volumeWeek": 0, "volumeMonth": 5578117.33, "volumeAllTime": 146808097.75, "pnlPercentDay": -5.100748023365772, "pnlPercentWeek": 2.6444537586748775, "pnlPercentMonth": -25.18126532124665, "pnlPercentAllTime": 8611.26123118416 }, { "address": "0xd4c1f7e8d876c4749228d515473d36f919583d1d", "age": "2025-07-23T21:20:00.002Z", "perpEquity": 4536454.6153, "openValue": 41523878.264966, "openValueLong": 1983228.203226, "exposureRatio": 9.153376763633727, "bias": -8.279025151457466, "pnlDay": -528211.737314, "pnlWeek": 1095388.571219, "pnlMonth": -2977410.056753, "pnlAllTime": 28835958.652565, "rank": 24, "volumeDay": 38100129.54, "volumeWeek": 209022971.19, "volumeMonth": 731098527.62, "volumeAllTime": 4584671215.15, "pnlPercentDay": -11.248647828972157, "pnlPercentWeek": 20.165243521555396, "pnlPercentMonth": -46.74308775689153, "pnlPercentAllTime": 150.6499929150401 }, { "address": "0xe4178ba889ac1c931861533b98bb86cb9d4858c7", "age": "2025-04-09T21:46:00.124Z", "perpEquity": 0.004056, "openValue": 0, "openValueLong": 0, "exposureRatio": 0, "bias": null, "pnlDay": 0, "pnlWeek": 0, "pnlMonth": 0, "pnlAllTime": 28269229.364056, "rank": 25, "volumeDay": 0, "volumeWeek": 0, "volumeMonth": 0, "volumeAllTime": 157936896.65, "pnlPercentDay": 0, "pnlPercentWeek": 0, "pnlPercentMonth": 0, "pnlPercentAllTime": 288.92733513130963 } ] } ``` {% endcode %}
*** ### Export Perp PnL Leaderboard `/api/external/leaderboards/perp-pnl/{period}/download` {% hint style="success" %} **Unique to HyperTracker Users** This export is generated from HyperTracker’s independently compiled perp leaderboard dataset, including wallet-level perp performance, exposure, volume, PnL percentage, and positioning metrics not available as a ready-made export from the standard Hyperliquid API. {% endhint %} Returns a temporary, pre-signed download URL for exporting the perp-only PnL leaderboard for a selected period. The exported file contains the same core wallet-level fields as the Perp PnL Leaderboard endpoint, including wallet address, perp equity, open value, long-side open value, PnL, PnL percentage, and trading volume across the relevant timeframe. Use this endpoint when you need to download the leaderboard as a file instead of paginating through API responses. Exports are limited to 25,000 rows per selected period, and the returned download link expires automatically after a short time.
Query Parameters
ParameterTypeDescription
periodstringLeaderboard period to export. Allowed values: 24h, 7d, 30d, all.
Request Examples {% tabs %} {% tab title="Curl" %} ``` curl --request GET \ --url 'https://ht-api.coinmarketman.com/api/external/leaderboards/perp-pnl/all/download' \ --header 'Authorization: Bearer YOUR_API_TOKEN' ``` {% endtab %} {% tab title="Python" %} ``` import requests response = requests.get( 'https://ht-api.coinmarketman.com/api/external/leaderboards/perp-pnl/all/download', headers={'Authorization': 'Bearer YOUR_API_TOKEN'} ) download_link = response.json() ``` {% endtab %} {% endtabs %} Response > 200 Success: Returns a temporary pre-signed download URL for the selected perp PnL leaderboard export.
Response Example {% code expandable="true" %} ``` [ { "address": "0x082e843a431aef031264dc232693dd710aedca88", "perpEquity": 18472178.849423, "openValue": 57053723.64972, "openValueLong": 57053723.64972, "pnlDay": 3564355.038546, "pnlWeek": -122076.444524, "pnlMonth": 16819083.289023, "pnlAllTime": 249592.445917, "volumeDay": 0, "volumeWeek": 0, "volumeMonth": 0, "volumeAllTime": 94884771.39, "pnlPercentDay": 24.0104616497315, "pnlPercentWeek": -0.587763847606627, "pnlPercentMonth": 401.908646838273, "pnlPercentAllTime": 0.875641615121957 }, { "address": "0xeadc152ac1014ace57c6b353f89adf5faffe9d55", "perpEquity": 31186378.24408, "openValue": 138118339.253674, "openValueLong": 136628987.826759, "pnlDay": 2776726.133462, "pnlWeek": -7797101.283362, "pnlMonth": 9150674.660106, "pnlAllTime": -18569232.887384, "volumeDay": 0, "volumeWeek": 17259658.68, "volumeMonth": 208273378.05, "volumeAllTime": 714830239.79, "pnlPercentDay": 10.0417480018821, "pnlPercentWeek": -20.3975647409841, "pnlPercentMonth": 30.8479570067147, "pnlPercentAllTime": -48.231369841972 }, { "address": "0xa5b0edf6b55128e0ddae8e51ac538c3188401d41", "perpEquity": 41783482.568422, "openValue": 203072870.08463, "openValueLong": 203072870.08463, "pnlDay": 2770305.462672, "pnlWeek": -8346036.779757, "pnlMonth": 22948370.47943, "pnlAllTime": 11593413.210329, "volumeDay": 0, "volumeWeek": 67659433.97, "volumeMonth": 251504340.97, "volumeAllTime": 1358663549.44, "pnlPercentDay": 7.02464602183992, "pnlPercentWeek": -19.1628191483878, "pnlPercentMonth": 71.6351656851812, "pnlPercentAllTime": 26.7190776363126 }, { "address": "0x6c8512516ce5669d35113a11ca8b8de322fd84f6", "perpEquity": 11583400.515941, "openValue": 109235012.88973, "openValueLong": 109235012.88973, "pnlDay": 1513793.559309, "pnlWeek": -6555687.58796, "pnlMonth": 11933169.936335, "pnlAllTime": 8481420.09295, "volumeDay": 0, "volumeWeek": 0, "volumeMonth": 9283472.34, "volumeAllTime": 100605733.35, "pnlPercentDay": 14.5792015530806, "pnlPercentWeek": -50.7721660436473, "pnlPercentMonth": 102.317607770646, "pnlPercentAllTime": 56.114014022028 }, { "address": "0x8def9f50456c6c4e37fa5d3d57f108ed23992dae", "perpEquity": 22201360.199108, "openValue": 24674622.97782, "openValueLong": 24674622.97782, "pnlDay": 1513282.645957, "pnlWeek": 691415.058583, "pnlMonth": -251562.636382, "pnlAllTime": 25451380.288949, "volumeDay": 417078.1, "volumeWeek": 28906975.02, "volumeMonth": 116998999.47, "volumeAllTime": 1098086732.09, "pnlPercentDay": 7.3426043410735, "pnlPercentWeek": 3.22616499039321, "pnlPercentMonth": -0.71518544634462, "pnlPercentAllTime": 176.412854329856 }, { "address": "0x61ceef212ff4a86933c69fb6aca2fe35d8f2a62b", "perpEquity": 6705786.807165, "openValue": 32922146.90937, "openValueLong": 27809768.00624, "pnlDay": 1207987.966127, "pnlWeek": 4410274.856709, "pnlMonth": 5431917.144095, "pnlAllTime": 4361805.409213, "volumeDay": 56654697.61, "volumeWeek": 1171767152.77, "volumeMonth": 3678722289.75, "volumeAllTime": 7097699730.83, "pnlPercentDay": 15.5862916479492, "pnlPercentWeek": 96.9709700650926, "pnlPercentMonth": 47.8905000936384, "pnlPercentAllTime": 40.6216836657082 }, { "address": "0x4f9b096385c4e66ce3dec9a17e150795b9a02e3f", "perpEquity": 2301924.587461, "openValue": 12940046, "openValueLong": 12940046, "pnlDay": 775860.058126, "pnlWeek": -16570.156024, "pnlMonth": 1778000.034724, "pnlAllTime": 1778000.034724, "volumeDay": 0, "volumeWeek": 0, "volumeMonth": 11058717.68, "volumeAllTime": 11058717.68, "pnlPercentDay": 51.134237623053, "pnlPercentWeek": -0.62464366982638, "pnlPercentMonth": 203.261021835178, "pnlPercentAllTime": 203.261021835178 }, { "address": "0x519c721de735f7c9e6146d167852e60d60496a47", "perpEquity": 10450208.225705, "openValue": 23713849.62893, "openValueLong": 23713849.62893, "pnlDay": 768356.086446, "pnlWeek": 432562.472005, "pnlMonth": 5076388.088514, "pnlAllTime": 6680459.795084, "volumeDay": 6487801.63, "volumeWeek": 80292857.1, "volumeMonth": 201798354.22, "volumeAllTime": 361565296.51, "pnlPercentDay": 7.9426165068664, "pnlPercentWeek": 4.32146118965041, "pnlPercentMonth": 94.6062030531339, "pnlPercentAllTime": 177.589751872248 }, { "address": "0x5b5d51203a0f9079f8aeb098a6523a13f298c060", "perpEquity": 23154492.60776, "openValue": 37715580.043569, "openValueLong": 3034446.1312, "pnlDay": 676910.490449, "pnlWeek": 3838560.110105, "pnlMonth": 2331584.292802, "pnlAllTime": 180248939.060521, "volumeDay": 2028237.16, "volumeWeek": 48764819.41, "volumeMonth": 84674554.36, "volumeAllTime": 3717674924.51, "pnlPercentDay": 2.98777797446473, "pnlPercentWeek": 19.5200824686545, "pnlPercentMonth": 11.1020898495977, "pnlPercentAllTime": 500.27880696514 }, { "address": "0xa9b95f2a2e7ef219021efc5c04c32761b8553bbd", "perpEquity": 1640806.38146, "openValue": 11162340, "openValueLong": 11162340, "pnlDay": 656810.173835, "pnlWeek": 37240.581335, "pnlMonth": 37240.581335, "pnlAllTime": 37240.581335, "volumeDay": 390194.22, "volumeWeek": 11040224.85, "volumeMonth": 11040224.85, "volumeAllTime": 11040224.85, "pnlPercentDay": 67.266060875863, "pnlPercentWeek": 2.33336127801561, "pnlPercentMonth": 2.33336127801561, "pnlPercentAllTime": 2.33336127801561 }, { "address": "0x985f02b19dbc062e565c981aac5614baf2cf501f", "perpEquity": 19022717.393541, "openValue": 21273409.591312, "openValueLong": 6137.76005, "pnlDay": 607348.752187, "pnlWeek": 1820983.182447, "pnlMonth": -2197810.817059, "pnlAllTime": 7802713.007591, "volumeDay": 8496241.56, "volumeWeek": 19401693.55, "volumeMonth": 97472570.11, "volumeAllTime": 266024183.39, "pnlPercentDay": 3.27281429284276, "pnlPercentWeek": 10.4993620832073, "pnlPercentMonth": -8.54650232096795, "pnlPercentAllTime": 55.1744240919967 }, { "address": "0x8af700ba841f30e0a3fcb0ee4c4a9d223e1efa05", "perpEquity": 11777346.609485, "openValue": 79293185.420748, "openValueLong": 73059851.30946, "pnlDay": 580247.067119, "pnlWeek": -641989.70222, "pnlMonth": -1900133.203077, "pnlAllTime": 51811486.707087, "volumeDay": 343997.01, "volumeWeek": 75618180.79, "volumeMonth": 185816254.8, "volumeAllTime": 4414115213.22, "pnlPercentDay": 5.13351897022668, "pnlPercentWeek": -5.18152265954263, "pnlPercentMonth": -14.3919561826645, "pnlPercentAllTime": 208.565375730159 }, { "address": "0x6666885961fec8ed58ddb45637ea41c02d6423f5", "perpEquity": 1216786.370416, "openValue": 9922080, "openValueLong": 9922080, "pnlDay": 534289.705395, "pnlWeek": -71936.313845, "pnlMonth": 19431.681417, "pnlAllTime": 19431.681417, "volumeDay": 1206861.11, "volumeWeek": 3697417.75, "volumeMonth": 9833576.69, "volumeAllTime": 9833576.69, "pnlPercentDay": 73.9177347798805, "pnlPercentWeek": -4.80656293778661, "pnlPercentMonth": 1.31544437630911, "pnlPercentAllTime": 1.31544437630911 }, { "address": "0x208db9f389989c5c387cc3a2620cc5251eace716", "perpEquity": 16108857.58735, "openValue": 17194288.559656, "openValueLong": 25899.898918, "pnlDay": 522661.172054, "pnlWeek": 1820120.74556, "pnlMonth": 1143979.268404, "pnlAllTime": 5651151.886178, "volumeDay": 1521336.59, "volumeWeek": 20675559.69, "volumeMonth": 55072240.13, "volumeAllTime": 467553039.61, "pnlPercentDay": 3.33075475191209, "pnlPercentWeek": 12.6445441825675, "pnlPercentMonth": 7.63885172266537, "pnlPercentAllTime": 53.9817770517101 }, { "address": "0x9c89f595f5515609ad61f6fda94beff85ae6600e", "perpEquity": 9913748.476578, "openValue": 34826120.79358, "openValueLong": 34826120.79358, "pnlDay": 520343.278522, "pnlWeek": -805053.413085, "pnlMonth": 3217351.368517, "pnlAllTime": -3900706.238349, "volumeDay": 0, "volumeWeek": 39701346.5, "volumeMonth": 45381907.15, "volumeAllTime": 381321553.79, "pnlPercentDay": 5.48534584710949, "pnlPercentWeek": -7.44629819181554, "pnlPercentMonth": 38.7318982918481, "pnlPercentAllTime": -28.23616238349 } ] ``` {% endcode %}
*** ### Get HYPE Holder Leaderboard `/api/external/hype/holders`
Returns a ranked leaderboard of HYPE token holders, including spot, staked, and total balances with USD equivalents. Each holder record includes wallet address, HYPE balances, account value, wallet age/earliest activity, rank, percentage of circulating supply owned, and enriched wallet profile data where available. Use this endpoint to analyse HYPE token distribution, identify top holders, and track large holder rankings over time.
Query Parameters
ParameterTypeDescription
offsetnumberNumber of holder records to skip before starting the returned list. Useful for pagination.
limitnumberMaximum number of holder records to return.
orderstringSort direction for the selected orderBy field. Allowed values: asc, desc. Default: desc.
orderBystringField used to sort the returned holder records. Example: totalAmount.
rankBystringField used to calculate holder rank. Example: totalAmount.
rankOrderstringRank direction. Allowed values: asc, desc. Default: desc.
Request Examples {% tabs %} {% tab title="Curl" %} ``` curl --request GET \ --url 'https://ht-api.coinmarketman.com/api/external/hype/holders?offset=0&limit=50&order=desc&orderBy=totalAmount&rankBy=totalAmount&rankOrder=desc' \ --header 'Authorization: Bearer YOUR_API_TOKEN' \ --header 'Accept: application/json' ``` {% endtab %} {% tab title="JavaScript" %} ``` const params = new URLSearchParams({ offset: '0', limit: '50', order: 'desc', orderBy: 'totalAmount', rankBy: 'totalAmount', rankOrder: 'desc' }); const response = await fetch( `https://ht-api.coinmarketman.com/api/external/hype/holders?${params}`, { headers: { Authorization: 'Bearer YOUR_API_TOKEN', Accept: 'application/json' } } ); if (!response.ok) { throw new Error(`Request failed: ${response.status} ${response.statusText}`); } const data = await response.json(); console.log(data); ``` {% endtab %} {% tab title="Python" %} ``` import requests response = requests.get( "https://ht-api.coinmarketman.com/api/external/hype/holders", params={ "offset": 0, "limit": 50, "order": "desc", "orderBy": "totalAmount", "rankBy": "totalAmount", "rankOrder": "desc", }, headers={ "Authorization": "Bearer YOUR_API_TOKEN", "Accept": "application/json", }, ) response.raise_for_status() data = response.json() print(data) ``` {% endtab %} {% endtabs %} Response > 200 Success: Returns all HYPE token holder data.
Response Example {% code expandable="true" %} ``` { "items": [ { "address": "0xd57ecca444a9acb7208d286be439de12dd09de5d", "spotAmount": 0, "spotAmountUsd": 0, "stakedAmount": 59989120.75987, "stakedAmountUsd": 2446116388.104468, "totalAmount": 59989120.75987, "totalAmountUsd": 2446116388.104468, "earliestActivityAt": "2024-12-04T22:42:00.059Z", "accountValue": 2457575451.0927, "rank": 2, "percentOfCirculatingSupply": 20.055, "wallet": { "mid": null, "cmmId": null, "xUserId": null, "displayName": null, "emoji": null, "verified": false, "segments": [ 16, 12 ], "address": "0xd57ecca444a9acb7208d286be439de12dd09de5d", "favoriteCount": 3, "totalEquity": 2457575451.0927, "earliestActivityAt": "2024-12-04T22:42:00.059Z", "perpPnl": -4, "perpEquity": 0, "exposureRatio": null, "perpBias": null, "openValue": 0, "sumUpnl": 0, "vault": null, "closestLiq": { "coin": null, "progress": null } }, "history": { "24h": { "id": 87961763, "address": "0xd57ecca444a9acb7208d286be439de12dd09de5d", "spotAmount": 0, "spotAmountUsd": 0, "stakedAmount": 59985532.177208, "stakedAmountUsd": 2256805684.336994, "totalAmount": 59985532.177208, "totalAmountUsd": 2256805684.336994, "createdAt": "2026-03-24T03:28:00.031Z" }, "7d": { "id": 85010477, "address": "0xd57ecca444a9acb7208d286be439de12dd09de5d", "spotAmount": 0, "spotAmountUsd": 0, "stakedAmount": 59964005.045688, "stakedAmountUsd": 2507904565.028327, "totalAmount": 59964005.045688, "totalAmountUsd": 2507904565.028327, "createdAt": "2026-03-18T03:28:00.038Z" } } }, { "address": "0x2222222222222222222222222222222222222222", "spotAmount": 55989230.674871, "spotAmountUsd": 2293458861.519413, "stakedAmount": 0, "stakedAmountUsd": 0, "totalAmount": 55989230.674871, "totalAmountUsd": 2293458861.519413, "earliestActivityAt": "2024-12-11T21:26:00.120Z", "accountValue": 2308768281.794389, "rank": 3, "percentOfCirculatingSupply": 18.718, "wallet": { "mid": null, "cmmId": null, "xUserId": null, "displayName": null, "emoji": null, "verified": false, "segments": [ 1, 11 ], "address": "0x2222222222222222222222222222222222222222", "favoriteCount": 0, "totalEquity": 2308768281.794389, "earliestActivityAt": "2024-12-11T21:26:00.120Z", "perpPnl": 0, "perpEquity": 420.5, "exposureRatio": 0, "perpBias": null, "openValue": 0, "sumUpnl": 0, "vault": null, "closestLiq": { "coin": null, "progress": null } }, "history": { "24h": { "id": 87939112, "address": "0x2222222222222222222222222222222222222222", "spotAmount": 55829248.897741, "spotAmountUsd": 2100435916.65527, "stakedAmount": 0, "stakedAmountUsd": 0, "totalAmount": 55829248.897741, "totalAmountUsd": 2100435916.65527, "createdAt": "2026-03-24T03:28:00.031Z" }, "7d": { "id": 85004051, "address": "0x2222222222222222222222222222222222222222", "spotAmount": 52226433.927089, "spotAmountUsd": 2184292259.349622, "stakedAmount": 0, "stakedAmountUsd": 0, "totalAmount": 52226433.927089, "totalAmountUsd": 2184292259.349622, "createdAt": "2026-03-18T03:28:00.038Z" } } }, { "address": "0xfefefefefefefefefefefefefefefefefefefefe", "spotAmount": 42591095.952555, "spotAmountUsd": 1744637767.956539, "stakedAmount": 0, "stakedAmountUsd": 0, "totalAmount": 42591095.952555, "totalAmountUsd": 1744637767.956539, "earliestActivityAt": "2025-01-15T22:06:00.150Z", "accountValue": 1738875472.782991, "rank": 4, "percentOfCirculatingSupply": 0, "wallet": { "mid": null, "cmmId": null, "xUserId": null, "displayName": null, "emoji": null, "verified": false, "segments": [ 1, 8 ], "address": "0xfefefefefefefefefefefefefefefefefefefefe", "favoriteCount": 1, "totalEquity": 1738875472.782991, "earliestActivityAt": "2025-01-15T22:06:00.150Z", "perpPnl": 972937087.915524, "perpEquity": 7004.257779, "exposureRatio": 0, "perpBias": null, "openValue": 0, "sumUpnl": 0, "vault": null, "closestLiq": { "coin": null, "progress": null } }, "history": { "24h": { "id": 87851313, "address": "0xfefefefefefefefefefefefefefefefefefefefe", "spotAmount": 42536924.112555, "spotAmountUsd": 1600345427.424605, "stakedAmount": 0, "stakedAmountUsd": 0, "totalAmount": 42536924.112555, "totalAmountUsd": 1600345427.424605, "createdAt": "2026-03-24T03:28:00.031Z" }, "7d": { "id": 84933125, "address": "0xfefefefefefefefefefefefefefefefefefefefe", "spotAmount": 42299096.762555, "spotAmountUsd": 1769096273.448724, "stakedAmount": 0, "stakedAmountUsd": 0, "totalAmount": 42299096.762555, "totalAmountUsd": 1769096273.448724, "createdAt": "2026-03-18T03:28:00.038Z" } } }, { "address": "0x393d0b87ed38fc779fd9611144ae649ba6082109", "spotAmount": 0, "spotAmountUsd": 0, "stakedAmount": 19682900.104024, "stakedAmountUsd": 802589934.641654, "totalAmount": 19682900.104024, "totalAmountUsd": 802589934.641654, "earliestActivityAt": "2025-07-16T22:59:21.039Z", "accountValue": 809971023.285322, "rank": 5, "percentOfCirculatingSupply": 6.58, "wallet": { "mid": null, "cmmId": null, "xUserId": null, "displayName": null, "emoji": null, "verified": false, "segments": [ 16, 11 ], "address": "0x393d0b87ed38fc779fd9611144ae649ba6082109", "favoriteCount": 1, "totalEquity": 809971023.285322, "earliestActivityAt": "2025-07-16T22:59:21.039Z", "perpPnl": 0, "perpEquity": 0, "exposureRatio": null, "perpBias": null, "openValue": 0, "sumUpnl": 0, "vault": null, "closestLiq": { "coin": null, "progress": null } }, "history": { "24h": { "id": 87949459, "address": "0x393d0b87ed38fc779fd9611144ae649ba6082109", "spotAmount": 0, "spotAmountUsd": 0, "stakedAmount": 19911629.010215, "stakedAmountUsd": 749125262.43681, "totalAmount": 19911629.010215, "totalAmountUsd": 749125262.43681, "createdAt": "2026-03-24T03:28:00.031Z" }, "7d": { "id": 85013035, "address": "0x393d0b87ed38fc779fd9611144ae649ba6082109", "spotAmount": 0, "spotAmountUsd": 0, "stakedAmount": 20638524.689483, "stakedAmountUsd": 863175337.350563, "totalAmount": 20638524.689483, "totalAmountUsd": 863175337.350563, "createdAt": "2026-03-18T03:28:00.038Z" } } }, { "address": "0xa20fcfa0507fe762011962cc581b95bbbc3bbdba", "spotAmount": 0, "spotAmountUsd": 0, "stakedAmount": 3083034.631176, "stakedAmountUsd": 125713820.120814, "totalAmount": 3083034.631176, "totalAmountUsd": 125713820.120814, "earliestActivityAt": "2024-12-04T21:58:00.087Z", "accountValue": 126940927.370696, "rank": 6, "percentOfCirculatingSupply": 1.031, "wallet": { "mid": null, "cmmId": null, "xUserId": null, "displayName": null, "emoji": null, "verified": false, "segments": [ 16, 11 ], "address": "0xa20fcfa0507fe762011962cc581b95bbbc3bbdba", "favoriteCount": 1, "totalEquity": 126940927.370696, "earliestActivityAt": "2024-12-04T21:58:00.087Z", "perpPnl": 0, "perpEquity": 0, "exposureRatio": null, "perpBias": null, "openValue": 0, "sumUpnl": 0, "vault": null, "closestLiq": { "coin": null, "progress": null } }, "history": { "24h": { "id": 87956119, "address": "0xa20fcfa0507fe762011962cc581b95bbbc3bbdba", "spotAmount": 0, "spotAmountUsd": 0, "stakedAmount": 3082850.338835, "stakedAmountUsd": 115984536.87281, "totalAmount": 3082850.338835, "totalAmountUsd": 115984536.87281, "createdAt": "2026-03-24T03:28:00.031Z" }, "7d": { "id": 85009035, "address": "0xa20fcfa0507fe762011962cc581b95bbbc3bbdba", "spotAmount": 0, "spotAmountUsd": 0, "stakedAmount": 3081744.616323, "stakedAmountUsd": 128889345.960799, "totalAmount": 3081744.616323, "totalAmountUsd": 128889345.960799, "createdAt": "2026-03-18T03:28:00.038Z" } } } ], "totalCount": 246383 } ``` {% 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/leaderboards.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.