> For the complete documentation index, see [llms.txt](https://docs.coinmarketman.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coinmarketman.com/endpoints/builder-analytics.md). # Builder Analytics The Builder Analytics endpoints provide structured access to HyperTracker’s curated builder dataset, powering the Live Builder Analytics dashboard. These endpoints expose performance metrics for every builder, including revenue, trading volume, user activity, and monetisation efficiency across multiple timeframes. Use these endpoints to rebuild the [Live Builder Analytics ](https://app.coinmarketman.com/hypertracker/builders)experience, create custom leaderboards, monitor builder performance, and identify which integrations are driving the most value across the ecosystem. *** ### Get Builder Leaderboard (By Timeframe) `/api/external/builders/list/timeframe/{timeframe}`
{% hint style="success" %} **Unique to HyperTracker Users** This endpoint is exclusive to HyperTracker. Builder-level performance metrics such as revenue, user counts, and volume over specific timeframes are not directly accessible via the Hyperliquid API and are reconstructed using aggregated referral data and activity tracking. {% endhint %} Returns a ranked leaderboard of all builders on the Hyperliquid network for a selected timeframe, ordered by revenue descending. The `timeframe` parameter allows you to switch between different performance views ( `24h`, `7d`, `30d`, or `all)` with all metrics (revenue, volume, users) calculated specifically for that period. This enables direct comparison of short-term and long-term builder performance. This endpoint powers the Builders table on the HyperTracker dashboard.
Path Parameters
ParameterTypeDescription
timeframestringTime period for builder performance metrics.
Available values: 24h, 7d, 30d, all
Request Examples {% tabs %} {% tab title="Curl" %} ``` curl -X GET \ 'https://ht-api.coinmarketman.com/api/external/builders/list/timeframe/7d' \ -H 'Authorization: Bearer YOUR_API_TOKEN' ``` {% endtab %} {% tab title="Python" %} ``` import requests timeframe = "7d" # Options: 24h, 7d, 30d, all response = requests.get( f"https://ht-api.coinmarketman.com/api/external/builders/list/timeframe/{timeframe}", headers={ "accept": "application/json", "Authorization": "Bearer YOUR_API_TOKEN", }, ) result = response.json() ``` {% endtab %} {% endtabs %} Response > **200 Success:** Returns a `builders` array containing all builders ranked by revenue for the selected timeframe, including current and previous period metrics.
Response Examples {% code expandable="true" %} ``` { "builders": [ { "refCode": "Phantom", "address": "0xb84168cf3be63c6b8dad05ff5d755e97432ff80b", "revenue": 26386.86369, "timeJoined": "2025-06-11T22:48:00.027Z", "createdAt": "2025-07-02T14:47:33.000Z", "usageFee": 0.000499996586779916, "users": 2764, "volume": 49917926.466761, "revenuePrev": 18072.279044, "volumePrev": 33556367.502711, "usersPrev": 2119 }, { "refCode": "MetaMask", "address": "0xe95a5e31904e005066614247d309e00d8ad753aa", "revenue": 17606.480207, "timeJoined": "2025-08-20T22:30:00.160Z", "createdAt": "2025-08-14T15:26:23.000Z", "usageFee": 0.000999937387738171, "users": 997, "volume": 17606483.81816, "revenuePrev": 11175.549454, "volumePrev": 11175552.1641, "usersPrev": 696 }, { "refCode": "Based", "address": "0x1924b8561eef20e70ede628a296175d358be80e5", "revenue": 8153.46633698, "timeJoined": "2025-06-11T20:44:00.135Z", "createdAt": "2025-07-02T14:47:30.000Z", "usageFee": 0.0007999989792741618, "users": 1322, "volume": 28090941.84813797, "revenuePrev": 10401.82440343, "volumePrev": 32245998.5659044, "usersPrev": 913 }, { "refCode": "TreadFi", "address": "0x999a4b5f268a8fbf33736feff360d462ad248dbf", "revenue": 6626.72524131, "timeJoined": "2025-04-23T21:52:00.046Z", "createdAt": "2025-07-02T14:47:32.000Z", "usageFee": 0.00019998472232831717, "users": 254, "volume": 33208198.97903304, "revenuePrev": 5999.18956998, "volumePrev": 30003912.660933, "usersPrev": 262 }, { "refCode": "Minara AI", "address": "0x5a3bc60b0a99a7f4fbf0d15554fa5fe88e7628c2", "revenue": 5304.76695, "timeJoined": "2025-12-24T21:52:00.030Z", "createdAt": "2025-12-22T16:34:27.000Z", "usageFee": 0.0002996784565916398, "users": 1163, "volume": 18660277.455064, "revenuePrev": 4295.258545, "volumePrev": 14667245.254393, "usersPrev": 1084 }, { "refCode": "Invo", "address": "0x557edb253b1d7ed5f15b248a5a3fd919fa5d3c81", "revenue": 4498.60755, "timeJoined": "2025-11-26T21:36:00.005Z", "createdAt": "2025-11-27T14:33:57.000Z", "usageFee": 0.00034998225012013574, "users": 2380, "volume": 12853207.418153, "revenuePrev": 1907.17627, "volumePrev": 5449101.40825, "usersPrev": 1909 }, { "refCode": "Rabby", "address": "0xad9be64fd7a35d99a138b87cb212baefbcdcf045", "revenue": 4443.309906, "timeJoined": "2025-08-27T21:08:00.018Z", "createdAt": "2025-08-26T19:53:17.000Z", "usageFee": 0.0001999971616846348, "users": 497, "volume": 22216565.733526, "revenuePrev": 3794.82671, "volumePrev": 18974129.427131, "usersPrev": 347 }, { "refCode": "METASCALP", "address": "0xa9ab442f9dfe752dc74b666c41e7a0498baf8687", "revenue": 3816.3773816, "timeJoined": "2025-09-11T21:46:00.019Z", "createdAt": "2025-09-11T09:05:14.000Z", "usageFee": 0.000199992409731617, "users": 101, "volume": 19088663.44900638, "revenuePrev": 599.97823628, "volumePrev": 2996192.39178915, "usersPrev": 87 }, { "refCode": "Dreamcash", "address": "0x4950994884602d1b6c6d96e4fe30f58205c39395", "revenue": 2730.43269481, "timeJoined": "2025-06-18T21:42:00.071Z", "createdAt": "2025-07-02T14:47:31.000Z", "usageFee": 0, "users": 495, "volume": 14605160.38993885, "revenuePrev": 907.16412223, "volumePrev": 4251723.36301936, "usersPrev": 406 }, { "refCode": "Liquid", "address": "0x6d4e7f472e6a491b98cbeed327417e310ae8ce48", "revenue": 2036.63584, "timeJoined": "2025-06-18T22:44:00.070Z", "createdAt": "2025-07-02T14:47:31.000Z", "usageFee": 0.0003499999012024106, "users": 248, "volume": 4585129.322214, "revenuePrev": 983.727747, "volumePrev": 2173751.50861, "usersPrev": 161 }, { "refCode": "Axiom", "address": "0x1cc34f6af34653c515b47a83e1de70ba9b0cda1f", "revenue": 1749.309014, "timeJoined": "2025-01-22T21:44:00.004Z", "createdAt": "2025-07-02T14:47:30.000Z", "usageFee": 0.00009998113563478589, "users": 288, "volume": 17493110.478239, "revenuePrev": 1264.729247, "volumePrev": 12647306.712767, "usersPrev": 215 }, { "refCode": "Insilico", "address": "0x2868fc0d9786a740b491577a43502259efa78a39", "revenue": 1612.8536693, "timeJoined": "2024-07-31T21:20:54.694Z", "createdAt": "2025-07-02T14:47:30.000Z", "usageFee": 0.00009999984116563964, "users": 187, "volume": 16257174.473237, "revenuePrev": 3425.44177937, "volumePrev": 34258292.551013, "usersPrev": 144 }, { "refCode": "PVP", "address": "0x0cbf655b0d22ae71fba3a674b0e1c0c7e7f975af", "revenue": 1364.79090144, "timeJoined": "2024-07-17T22:40:00.093Z", "createdAt": "2025-07-02T14:47:29.000Z", "usageFee": 0.00036999978162537963, "users": 38, "volume": 4955829.310078, "revenuePrev": 337.822389, "volumePrev": 1025136.538908, "usersPrev": 28 }, { "refCode": "Infinex", "address": "0xcf56dd84ed85eb4929e0a76a0f2f04049b4ffc1a", "revenue": 1352.349238, "timeJoined": "2025-08-20T22:38:00.072Z", "createdAt": "2025-08-19T03:32:48.000Z", "usageFee": 0.000499988148328745, "users": 36, "volume": 2704699.583632, "revenuePrev": 734.576623, "volumePrev": 1469153.777001, "usersPrev": 22 }, ``` {% endcode %}
*** ### Get Builder Profile (Detailed Analytics) `/api/external/builders/{builder}/profile`
{% hint style="success" %} **Unique to HyperTracker Users** This endpoint is exclusive to HyperTracker. It provides a fully aggregated builder profile, including time-based revenue, user activity, and volume analytics, which are not directly accessible via the Hyperliquid API. {% endhint %} Returns a comprehensive analytics profile for a specific builder, identified by their wallet address. Time-based datasets are structured using a column + data format, allowing efficient reconstruction of charts and analytics visualisations. This endpoint powers the Builder Profile page on the HyperTracker dashboard and provides a complete, structured view of builder performance and user activity.
Path Parameters
ParameterTypeDescription
builderstringThe builder's wallet address.
Request Examples {% tabs %} {% tab title="Curl" %} ``` curl -X GET \ 'https://ht-api.coinmarketman.com/api/external/builders/{builder}/profile' \ -H 'accept: application/json' \ -H 'Authorization: Bearer YOUR_API_TOKEN' ``` {% endtab %} {% tab title="Python" %} ``` import requests builder = "BUILDER ADDRESS" response = requests.get( f"https://ht-api.coinmarketman.com/api/external/builders/{builder}/profile", headers={ "accept": "application/json", "Authorization": "Bearer YOUR_API_TOKEN", }, ) result = response.json() ``` {% endtab %} {% endtabs %} Response > **200 Success:** Returns a full analytics profile for the specified builder, including metadata, performance metrics, time-series data, and distribution breakdowns.
Response Examples {% code expandable="true" %} ``` { "info": { "address": "0xb84168cf3be63c6b8dad05ff5d755e97432ff80b", "code": "Phantom", "name": "Crypto Wallet", "url": null, "xUrl": "https://x.com/phantom", "xUserId": "1379053041995890695", "xUser": { "xUserId": "1379053041995890695", "data": { "name": "Phantom", "verified": true, "screenName": "phantom", "description": "Your home for trading crypto, predictions, and more. Get support at https://t.co/4xgbjivJbA\nNot for UK users. See @phantom__UK", "publicMetrics": { "tweetCount": 57246, "listedCount": 3650, "followersCount": 945132, "followingCount": 1541 }, "profileImageUrl": "https://pbs.twimg.com/profile_images/1973036509449121792/ePaMAzyA_normal.jpg" }, "createdAt": "2025-07-31T15:21:57.103Z", "updatedAt": "2026-04-26T21:28:00.821Z", "followersCount": 945132 }, "firstActivityAt": "2025-06-11T22:48:00.027Z", "revenue": 19448375.01427135 }, "hyperliquidVolume24h": 3097563360.443404, "fee": 0.0004999995850092045, "biggestDay": { "revenue": 233278.164062, "date": "2025-08-14T00:00:00.000Z" }, "revenueMilestones": [ { "revenue": 10000, "label": "10k", "done": true, "date": "2025-07-10T00:00:00.000Z" }, { "label": "100k", "revenue": 100000, "done": true, "date": "2025-07-14T00:00:00.000Z" } ], "analytics": { "24h": { "columns": [ "revenue", "users", "timestamp" ], "data": [ [ 13.647788, 11, "2026-04-27T06:00:00.000Z" ], [ 5269.606458, 577, "2026-04-27T05:00:00.000Z" ], [ 654.26863499, 259, "2026-04-27T04:00:00.000Z" ], [ 1012.87885801, 287, "2026-04-27T03:00:00.000Z" ], [ 1409.147824, 286, "2026-04-27T02:00:00.000Z" ], [ 1743.043662, 416, "2026-04-27T01:00:00.000Z" ], [ 1768.861848, 356, "2026-04-27T00:00:00.000Z" ], [ 1580.965724, 226, "2026-04-26T23:00:00.000Z" ], [ 1314.071588, 340, "2026-04-26T22:00:00.000Z" ], [ 1421.656929, 341, "2026-04-26T21:00:00.000Z" ], [ 619.671845, 276, "2026-04-26T20:00:00.000Z" ], [ 1385.968549, 381, "2026-04-26T19:00:00.000Z" ], [ 578.273604, 308, "2026-04-26T18:00:00.000Z" ], [ 964.770022, 209, "2026-04-26T17:00:00.000Z" ], [ 540.778358, 194, "2026-04-26T16:00:00.000Z" ], [ 747.402292, 205, "2026-04-26T15:00:00.000Z" ], [ 1218.393539, 245, "2026-04-26T14:00:00.000Z" ], [ 490.058123, 207, "2026-04-26T13:00:00.000Z" ], [ 796.545994, 241, "2026-04-26T12:00:00.000Z" ], [ 361.14806099, 200, "2026-04-26T11:00:00.000Z" ], [ 288.176567, 168, "2026-04-26T10:00:00.000Z" ], [ 815.748483, 147, "2026-04-26T09:00:00.000Z" ], [ 993.896667, 206, "2026-04-26T08:00:00.000Z" ], [ 281.278842, 168, "2026-04-26T07:00:00.000Z" ], [ 1337.234914, 152, "2026-04-26T06:00:00.000Z" ] ] }, "7d": { "columns": [ "revenue", "users", "timestamp" ], "data": [ [ 11823.43908, 1402, "2026-04-27T00:00:00.000Z" ], [ 19182.458474, 2375, "2026-04-26T00:00:00.000Z" ], [ 17188.24108, 2131, "2026-04-25T00:00:00.000Z" ], [ 34374.537844, 2849, "2026-04-24T00:00:00.000Z" ], [ 37097.031306, 3546, "2026-04-23T00:00:00.000Z" ], [ 39025.664693, 4139, "2026-04-22T00:00:00.000Z" ], [ 35763.806481, 3418, "2026-04-21T00:00:00.000Z" ] ] }, "30d": { "columns": [ "revenue", "users", "timestamp" ], "data": [ [ 11823.43908, 1402, "2026-04-27T00:00:00.000Z" ], [ 19182.458474, 2375, "2026-04-26T00:00:00.000Z" ], [ 17188.24108, 2131, "2026-04-25T00:00:00.000Z" ], [ 34374.537844, 2849, "2026-04-24T00:00:00.000Z" ], [ 37097.031306, 3546, "2026-04-23T00:00:00.000Z" ], [ 39025.664693, 4139, "2026-04-22T00:00:00.000Z" ], [ 35763.806481, 3418, "2026-04-21T00:00:00.000Z" ], [ 31682.838974, 3464, "2026-04-20T00:00:00.000Z" ], [ 36044.430759, 3670, "2026-04-19T00:00:00.000Z" ], [ 27219.840317, 3431, "2026-04-18T00:00:00.000Z" ], [ 63689.755542, 4458, "2026-04-17T00:00:00.000Z" ], [ 42898.884289, 3824, "2026-04-16T00:00:00.000Z" ], [ 33619.955392, 3414, "2026-04-15T00:00:00.000Z" ], [ 50967.304696, 4338, "2026-04-14T00:00:00.000Z" ], [ 53851.749374, 4141, "2026-04-13T00:00:00.000Z" ], [ 56361.652075, 3960, "2026-04-12T00:00:00.000Z" ], [ 33819.302726, 2929, "2026-04-11T00:00:00.000Z" ], [ 41798.216031, 3564, "2026-04-10T00:00:00.000Z" ], [ 55925.245201, 3965, "2026-04-09T00:00:00.000Z" ], [ 73675.152204, 4720, "2026-04-08T00:00:00.000Z" ], [ 83971.372217, 4684, "2026-04-07T00:00:00.000Z" ], [ 42327.532549, 3848, "2026-04-06T00:00:00.000Z" ], [ 33951.427488, 2809, "2026-04-05T00:00:00.000Z" ], [ 14234.939106, 2118, "2026-04-04T00:00:00.000Z" ], [ 29443.239261, 2651, "2026-04-03T00:00:00.000Z" ], [ 69046.187307, 4343, "2026-04-02T00:00:00.000Z" ], [ 48422.138335, 3723, "2026-04-01T00:00:00.000Z" ], [ 69535.156387, 3836, "2026-03-31T00:00:00.000Z" ], [ 44299.185151, 3698, "2026-03-30T00:00:00.000Z" ], [ 25153.808876, 3158, "2026-03-29T00:00:00.000Z" ] ] }, "all": { "columns": [ "revenue", "users", "timestamp" ], "data": [ [ 11823.43908, 1402, "2026-04-27T00:00:00.000Z" ], [ 19182.458474, 2375, "2026-04-26T00:00:00.000Z" ], [ 17188.24108, 2131, "2026-04-25T00:00:00.000Z" ], [ 34374.537844, 2849, "2026-04-24T00:00:00.000Z" ], [ 37097.031306, 3546, "2026-04-23T00:00:00.000Z" ], [ 39025.664693, 4139, "2026-04-22T00:00:00.000Z" ], [ 35763.806481, 3418, "2026-04-21T00:00:00.000Z" ], [ 31682.838974, 3464, "2026-04-20T00:00:00.000Z" ], [ 36044.430759, 3670, "2026-04-19T00:00:00.000Z" ], [ 27219.840317, 3431, "2026-04-18T00:00:00.000Z" ], [ 63689.755542, 4458, "2026-04-17T00:00:00.000Z" ], [ 42898.884289, 3824, "2026-04-16T00:00:00.000Z" ], [ 33619.955392, 3414, "2026-04-15T00:00:00.000Z" ], [ 50967.304696, 4338, "2026-04-14T00:00:00.000Z" ], [ 53851.749374, 4141, "2026-04-13T00:00:00.000Z" ], [ 56361.652075, 3960, "2026-04-12T00:00:00.000Z" ], [ 33819.302726, 2929, "2026-04-11T00:00:00.000Z" ], [ 41798.216031, 3564, "2026-04-10T00:00:00.000Z" ], [ 55925.245201, 3965, "2026-04-09T00:00:00.000Z" ], [ 73675.152204, 4720, "2026-04-08T00:00:00.000Z" ], [ 83971.372217, 4684, "2026-04-07T00:00:00.000Z" ], [ 42327.532549, 3848, "2026-04-06T00:00:00.000Z" ], [ 33951.427488, 2809, "2026-04-05T00:00:00.000Z" ], [ 14234.939106, 2118, "2026-04-04T00:00:00.000Z" ], [ 29443.239261, 2651, "2026-04-03T00:00:00.000Z" ], [ 69046.187307, 4343, "2026-04-02T00:00:00.000Z" ], [ 48422.138335, 3723, "2026-04-01T00:00:00.000Z" ], [ 69535.156387, 3836, "2026-03-31T00:00:00.000Z" ], [ 44299.185151, 3698, "2026-03-30T00:00:00.000Z" ], [ 25153.808876, 3158, "2026-03-29T00:00:00.000Z" ], [ 21862.272134, 2925, "2026-03-28T00:00:00.000Z" ], [ 62870.071228, 4425, "2026-03-27T00:00:00.000Z" ], [ 47492.06502, 4092, "2026-03-26T00:00:00.000Z" ], [ 42842.667754, 3739, "2026-03-25T00:00:00.000Z" ], [ 54151.628635, 3896, "2026-03-24T00:00:00.000Z" ], [ 78391.639703, 5032, "2026-03-23T00:00:00.000Z" ], [ 42310.909068, 3856, "2026-03-22T00:00:00.000Z" ], [ 20836.043441, 2818, "2026-03-21T00:00:00.000Z" ], [ 64514.980001, 3896, "2026-03-20T00:00:00.000Z" ], [ 79322.929352, 5062, "2026-03-19T00:00:00.000Z" ], [ 73169.223596, 5166, "2026-03-18T00:00:00.000Z" ], [ 64564.155017, 4562, "2026-03-17T00:00:00.000Z" ], [ 88177.122902, 5540, "2026-03-16T00:00:00.000Z" ], [ 42838.548703, 4007, "2026-03-15T00:00:00.000Z" ], [ 29443.013351, 3689, "2026-03-14T00:00:00.000Z" ], [ 109981.042223, 5340, "2026-03-13T00:00:00.000Z" ], [ 65860.393966, 4331, "2026-03-12T00:00:00.000Z" ], [ 71461.307995, 4330, "2026-03-11T00:00:00.000Z" ], [ 85206.653649, 5278, "2026-03-10T00:00:00.000Z" ], [ 93529.647214, 5971, "2026-03-09T00:00:00.000Z" ], [ 104607.515806, 4576, "2026-03-08T00:00:00.000Z" ], [ 31205.047944, 3794, "2026-03-07T00:00:00.000Z" ], [ 76268.453409, 5035, "2026-03-06T00:00:00.000Z" ], [ 61603.842244, 4901, "2026-03-05T00:00:00.000Z" ], [ 93530.51476, 6023, "2026-03-04T00:00:00.000Z" ], [ 75125.854002, 5391, "2026-03-03T00:00:00.000Z" ], [ 74385.587106, 6157, "2026-03-02T00:00:00.000Z" ], [ 47318.595562, 5276, "2026-03-01T00:00:00.000Z" ], [ 79329.099151, 5406, "2026-02-28T00:00:00.000Z" ], [ 51609.409542, 4267, "2026-02-27T00:00:00.000Z" ], [ 93606.339057, 4272, "2026-02-26T00:00:00.000Z" ], [ 74917.835165, 5369, "2026-02-25T00:00:00.000Z" ], [ 51622.085151, 4440, "2026-02-24T00:00:00.000Z" ], [ 61783.180028, 4969, "2026-02-23T00:00:00.000Z" ], [ 16627.773515, 3112, "2026-02-22T00:00:00.000Z" ], [ 18090.244131, 3017, "2026-02-21T00:00:00.000Z" ], [ 40341.131414, 3951, "2026-02-20T00:00:00.000Z" ], [ 34533.277375, 3677, "2026-02-19T00:00:00.000Z" ], [ 39536.079508, 3900, "2026-02-18T00:00:00.000Z" ], [ 38403.751943, 3768, "2026-02-17T00:00:00.000Z" ], [ 39908.363708, 3836, "2026-02-16T00:00:00.000Z" ], [ 52665.542353, 4462, "2026-02-15T00:00:00.000Z" ], [ 32366.751941, 4254, "2026-02-14T00:00:00.000Z" ], [ 57022.853815, 4916, "2026-02-13T00:00:00.000Z" ], [ 56827.321354, 5128, "2026-02-12T00:00:00.000Z" ], [ 84025.176974, 5611, "2026-02-11T00:00:00.000Z" ], [ 57062.006931, 4832, "2026-02-10T00:00:00.000Z" ], [ 71909.05308, 5306, "2026-02-09T00:00:00.000Z" ], [ 50855.69642, 5054, "2026-02-08T00:00:00.000Z" ], [ 74046.099981, 5683, "2026-02-07T00:00:00.000Z" ], [ 161882.763731, 9109, "2026-02-06T00:00:00.000Z" ], [ 183014.550578, 9320, "2026-02-05T00:00:00.000Z" ], [ 88518.481414, 6817, "2026-02-04T00:00:00.000Z" ], [ 79056.655529, 6915, "2026-02-03T00:00:00.000Z" ], [ 86777.084198, 6592, "2026-02-02T00:00:00.000Z" ], [ 70226.722059, 6050, "2026-02-01T00:00:00.000Z" ], [ 78747.126132, 7570, "2026-01-31T00:00:00.000Z" ], [ 123538.235456, 7837, "2026-01-30T00:00:00.000Z" ], [ 99423.546027, 7943, "2026-01-29T00:00:00.000Z" ], [ 46752.394914, 5569, "2026-01-28T00:00:00.000Z" ], [ 53746.796165, 5300, "2026-01-27T00:00:00.000Z" ], [ 72483.840694, 5538, "2026-01-26T00:00:00.000Z" ], [ 41552.198937, 5283, "2026-01-25T00:00:00.000Z" ], [ 13034.140293, 3298, "2026-01-24T00:00:00.000Z" ], [ 41510.544869, 4395, "2026-01-23T00:00:00.000Z" ], [ 30690.590768, 4173, "2026-01-22T00:00:00.000Z" ], [ 59204.760873, 5382, "2026-01-21T00:00:00.000Z" ], [ 49175.663558, 5495, "2026-01-20T00:00:00.000Z" ], [ 42768.227395, 5245, "2026-01-19T00:00:00.000Z" ], [ 25170.65465, 3403, "2026-01-18T00:00:00.000Z" ], [ 18820.3584, 2778, "2026-01-17T00:00:00.000Z" ], [ 34611.434035, 3816, "2026-01-16T00:00:00.000Z" ], [ 62128.935848, 4616, "2026-01-15T00:00:00.000Z" ], [ 78030.803031, 5524, "2026-01-14T00:00:00.000Z" ], [ 63074.961514, 5094, "2026-01-13T00:00:00.000Z" ], [ 54603.753195, 4388, "2026-01-12T00:00:00.000Z" ], [ 17754.570546, 3110, "2026-01-11T00:00:00.000Z" ], [ 14305.370989, 2727, "2026-01-10T00:00:00.000Z" ], [ 37622.282874, 3906, "2026-01-09T00:00:00.000Z" ], [ 53106.74359, 4701, "2026-01-08T00:00:00.000Z" ], [ 51763.253109, 4629, "2026-01-07T00:00:00.000Z" ], [ 68976.796731, 5507, "2026-01-06T00:00:00.000Z" ], [ 66423.765125, 5215, "2026-01-05T00:00:00.000Z" ], [ 31545.896562, 4075, "2026-01-04T00:00:00.000Z" ], [ 32668.795065, 3530, "2026-01-03T00:00:00.000Z" ], [ 66368.264747, 4401, "2026-01-02T00:00:00.000Z" ], [ 21612.451763, 2477, "2026-01-01T00:00:00.000Z" ], [ 39573.252489, 2953, "2025-12-31T00:00:00.000Z" ], [ 38094.476286, 3058, "2025-12-30T00:00:00.000Z" ], [ 56029.917327, 3896, "2025-12-29T00:00:00.000Z" ], [ 20252.308626, 2547, "2025-12-28T00:00:00.000Z" ], [ 20151.176868, 2447, "2025-12-27T00:00:00.000Z" ], [ 46104.590958, 3112, "2025-12-26T00:00:00.000Z" ], [ 25831.161064, 2600, "2025-12-25T00:00:00.000Z" ], [ 34251.168136, 2814, "2025-12-24T00:00:00.000Z" ], [ 41174.689685, 3244, "2025-12-23T00:00:00.000Z" ], [ 46126.687822, 3497, "2025-12-22T00:00:00.000Z" ], [ 22211.579894, 2638, "2025-12-21T00:00:00.000Z" ], [ 19457.470057, 2492, "2025-12-20T00:00:00.000Z" ], [ 56751.64105, 4037, "2025-12-19T00:00:00.000Z" ], [ 78235.405258, 4625, "2025-12-18T00:00:00.000Z" ], [ 75312.050759, 4247, "2025-12-17T00:00:00.000Z" ], [ 56354.095165, 3618, "2025-12-16T00:00:00.000Z" ], [ 80928.306371, 4773, "2025-12-15T00:00:00.000Z" ], [ 58659.246314, 3734, "2025-12-14T00:00:00.000Z" ], [ 18788.978695, 2879, "2025-12-13T00:00:00.000Z" ], [ 56588.643146, 4249, "2025-12-12T00:00:00.000Z" ], [ 61987.123915, 4609, "2025-12-11T00:00:00.000Z" ], [ 72699.061235, 4304, "2025-12-10T00:00:00.000Z" ], [ 65328.138291, 4693, "2025-12-09T00:00:00.000Z" ], [ 54936.773583, 3995, "2025-12-08T00:00:00.000Z" ], [ 46848.466736, 4080, "2025-12-07T00:00:00.000Z" ], [ 23901.131594, 3207, "2025-12-06T00:00:00.000Z" ], [ 69932.685637, 4454, "2025-12-05T00:00:00.000Z" ], [ 74967.397782, 4267, "2025-12-04T00:00:00.000Z" ], [ 80053.369344, 4979, "2025-12-03T00:00:00.000Z" ], [ 77425.925356, 5175, "2025-12-02T00:00:00.000Z" ], [ 100088.596044, 5859, "2025-12-01T00:00:00.000Z" ], [ 33810.435254, 3186, "2025-11-30T00:00:00.000Z" ], [ 29357.597199, 3058, "2025-11-29T00:00:00.000Z" ], [ 62979.212716, 4374, "2025-11-28T00:00:00.000Z" ], [ 56181.08951, 4378, "2025-11-27T00:00:00.000Z" ], [ 46942.926844, 4650, "2025-11-26T00:00:00.000Z" ], [ 51089.634067, 4657, "2025-11-25T00:00:00.000Z" ], [ 68205.46333, 5269, "2025-11-24T00:00:00.000Z" ], [ 49496.253873, 4798, "2025-11-23T00:00:00.000Z" ], [ 41508.712669, 4023, "2025-11-22T00:00:00.000Z" ], [ 128163.395924, 6679, "2025-11-21T00:00:00.000Z" ], [ 90870.891581, 5889, "2025-11-20T00:00:00.000Z" ], [ 67903.340522, 5473, "2025-11-19T00:00:00.000Z" ], [ 82065.459613, 5546, "2025-11-18T00:00:00.000Z" ], [ 90036.000873, 5375, "2025-11-17T00:00:00.000Z" ], [ 64054.757242, 4764, "2025-11-16T00:00:00.000Z" ], [ 44835.662469, 4218, "2025-11-15T00:00:00.000Z" ], [ 105534.101419, 6273, "2025-11-14T00:00:00.000Z" ], [ 99153.325227, 6426, "2025-11-13T00:00:00.000Z" ], [ 62295.249453, 5163, "2025-11-12T00:00:00.000Z" ], [ 67415.781013, 5312, "2025-11-11T00:00:00.000Z" ], [ 110113.591716, 5535, "2025-11-10T00:00:00.000Z" ], [ 80804.728817, 4613, "2025-11-09T00:00:00.000Z" ], [ 86755.965174, 4467, "2025-11-08T00:00:00.000Z" ], [ 95294.738484, 5508, "2025-11-07T00:00:00.000Z" ], [ 129623.166595, 4763, "2025-11-06T00:00:00.000Z" ], [ 89784.31563, 6003, "2025-11-05T00:00:00.000Z" ], [ 144021.281393, 7365, "2025-11-04T00:00:00.000Z" ], [ 123323.52814, 6495, "2025-11-03T00:00:00.000Z" ], [ 45302.378201, 3882, "2025-11-02T00:00:00.000Z" ], [ 48367.785836, 3634, "2025-11-01T00:00:00.000Z" ], [ 74750.628244, 4949, "2025-10-31T00:00:00.000Z" ], [ 111594.97265, 6234, "2025-10-30T00:00:00.000Z" ], [ 106632.45432, 5309, "2025-10-29T00:00:00.000Z" ], [ 111521.299253, 5128, "2025-10-28T00:00:00.000Z" ], [ 111619.134099, 5442, "2025-10-27T00:00:00.000Z" ], [ 85348.303956, 4989, "2025-10-26T00:00:00.000Z" ], [ 38561.865536, 3590, "2025-10-25T00:00:00.000Z" ], [ 68408.807718, 4338, "2025-10-24T00:00:00.000Z" ], [ 66383.846807, 4719, "2025-10-23T00:00:00.000Z" ], [ 75452.57355, 5012, "2025-10-22T00:00:00.000Z" ], [ 102206.978452, 5035, "2025-10-21T00:00:00.000Z" ], [ 76397.456367, 4835, "2025-10-20T00:00:00.000Z" ], [ 52957.320569, 4270, "2025-10-19T00:00:00.000Z" ], [ 39083.63045, 3751, "2025-10-18T00:00:00.000Z" ], [ 141752.362227, 6064, "2025-10-17T00:00:00.000Z" ], [ 98689.814983, 5712, "2025-10-16T00:00:00.000Z" ], [ 103226.463358, 5047, "2025-10-15T00:00:00.000Z" ], [ 151768.576918, 6225, "2025-10-14T00:00:00.000Z" ], [ 98024.302198, 6064, "2025-10-13T00:00:00.000Z" ], [ 102305.619131, 6498, "2025-10-12T00:00:00.000Z" ], [ 106093.03845, 6610, "2025-10-11T00:00:00.000Z" ], [ 194130.268186, 8123, "2025-10-10T00:00:00.000Z" ], [ 79435.330383, 5133, "2025-10-09T00:00:00.000Z" ], [ 85382.350582, 4696, "2025-10-08T00:00:00.000Z" ], [ 116568.782265, 5757, "2025-10-07T00:00:00.000Z" ], [ 97454.53691, 5207, "2025-10-06T00:00:00.000Z" ], [ 92155.204584, 4958, "2025-10-05T00:00:00.000Z" ], [ 55705.74839, 4121, "2025-10-04T00:00:00.000Z" ], [ 93975.818847, 5223, "2025-10-03T00:00:00.000Z" ], [ 104954.898572, 5481, "2025-10-02T00:00:00.000Z" ], [ 92946.033912, 4929, "2025-10-01T00:00:00.000Z" ], [ 77971.192745, 4021, "2025-09-30T00:00:00.000Z" ], [ 79491.402215, 4106, "2025-09-29T00:00:00.000Z" ], [ 54382.437027, 3432, "2025-09-28T00:00:00.000Z" ], [ 35406.979773, 2893, "2025-09-27T00:00:00.000Z" ], [ 71456.215842, 4108, "2025-09-26T00:00:00.000Z" ], [ 102058.989094, 5299, "2025-09-25T00:00:00.000Z" ], [ 48038.108126, 4247, "2025-09-24T00:00:00.000Z" ], [ 62664.698053, 4261, "2025-09-23T00:00:00.000Z" ], [ 85971.37065, 5958, "2025-09-22T00:00:00.000Z" ], [ 33136.865072, 3603, "2025-09-21T00:00:00.000Z" ], [ 35819.034489, 3266, "2025-09-20T00:00:00.000Z" ], [ 54536.32981, 4043, "2025-09-19T00:00:00.000Z" ], [ 72570.220297, 4166, "2025-09-18T00:00:00.000Z" ], [ 89164.129298, 4136, "2025-09-17T00:00:00.000Z" ], [ 53911.809368, 3426, "2025-09-16T00:00:00.000Z" ], [ 98081.883022, 4149, "2025-09-15T00:00:00.000Z" ], [ 84418.90397, 3916, "2025-09-14T00:00:00.000Z" ], [ 70639.60566, 3958, "2025-09-13T00:00:00.000Z" ], [ 80527.7262, 4700, "2025-09-12T00:00:00.000Z" ], [ 61992.100362, 3721, "2025-09-11T00:00:00.000Z" ], [ 65583.242254, 3929, "2025-09-10T00:00:00.000Z" ], [ 69974.666753, 3745, "2025-09-09T00:00:00.000Z" ], [ 59884.937663, 3884, "2025-09-08T00:00:00.000Z" ], [ 25206.040042, 2612, "2025-09-07T00:00:00.000Z" ], [ 21962.026673, 2403, "2025-09-06T00:00:00.000Z" ], [ 103306.81169, 3251, "2025-09-05T00:00:00.000Z" ], [ 68557.264834, 3398, "2025-09-04T00:00:00.000Z" ], [ 47452.743724, 3265, "2025-09-03T00:00:00.000Z" ], [ 70388.471376, 3803, "2025-09-02T00:00:00.000Z" ], [ 64207.551116, 4582, "2025-09-01T00:00:00.000Z" ], [ 44547.043053, 3295, "2025-08-31T00:00:00.000Z" ], [ 41634.939682, 3010, "2025-08-30T00:00:00.000Z" ], [ 114444.609641, 4541, "2025-08-29T00:00:00.000Z" ], [ 88101.29696, 3910, "2025-08-28T00:00:00.000Z" ], [ 106093.139556, 4057, "2025-08-27T00:00:00.000Z" ], [ 117632.494335, 4156, "2025-08-26T00:00:00.000Z" ], [ 131953.114932, 4901, "2025-08-25T00:00:00.000Z" ], [ 142994.66434, 4388, "2025-08-24T00:00:00.000Z" ], [ 72891.71435, 3833, "2025-08-23T00:00:00.000Z" ], [ 142194.89247, 5193, "2025-08-22T00:00:00.000Z" ], [ 59711.242306, 3382, "2025-08-21T00:00:00.000Z" ], [ 95578.71199, 3759, "2025-08-20T00:00:00.000Z" ], [ 102837.570159, 3983, "2025-08-19T00:00:00.000Z" ], [ 116140.007643, 4082, "2025-08-18T00:00:00.000Z" ], [ 80650.131593, 3128, "2025-08-17T00:00:00.000Z" ], [ 40293.764899, 2648, "2025-08-16T00:00:00.000Z" ], [ 134365.610288, 4011, "2025-08-15T00:00:00.000Z" ], [ 233278.164062, 5594, "2025-08-14T00:00:00.000Z" ], [ 220202.559201, 5242, "2025-08-13T00:00:00.000Z" ], [ 137228.541649, 4615, "2025-08-12T00:00:00.000Z" ], [ 105068.511295, 4646, "2025-08-11T00:00:00.000Z" ], [ 68347.556078, 3823, "2025-08-10T00:00:00.000Z" ], [ 62708.846642, 4002, "2025-08-09T00:00:00.000Z" ], [ 55886.63219, 3926, "2025-08-08T00:00:00.000Z" ], [ 51948.135974, 3891, "2025-08-07T00:00:00.000Z" ], [ 36594.348787, 2833, "2025-08-06T00:00:00.000Z" ], [ 53682.914226, 3492, "2025-08-05T00:00:00.000Z" ], [ 50651.480533, 3694, "2025-08-04T00:00:00.000Z" ], [ 34955.47085, 3404, "2025-08-03T00:00:00.000Z" ], [ 44352.275271, 3559, "2025-08-02T00:00:00.000Z" ], [ 68662.200398, 4470, "2025-08-01T00:00:00.000Z" ], [ 44442.731602, 3758, "2025-07-31T00:00:00.000Z" ], [ 45410.074673, 3691, "2025-07-30T00:00:00.000Z" ], [ 43843.51124, 3749, "2025-07-29T00:00:00.000Z" ], [ 52459.64694, 4320, "2025-07-28T00:00:00.000Z" ], [ 42507.2466, 3616, "2025-07-27T00:00:00.000Z" ], [ 38345.375045, 3618, "2025-07-26T00:00:00.000Z" ], [ 84543.541085, 4364, "2025-07-25T00:00:00.000Z" ], [ 94849.773674, 4647, "2025-07-24T00:00:00.000Z" ], [ 90819.757915, 5361, "2025-07-23T00:00:00.000Z" ], [ 122257.504813, 5280, "2025-07-22T00:00:00.000Z" ], [ 117691.582311, 5299, "2025-07-21T00:00:00.000Z" ], [ 92299.12504, 3188, "2025-07-20T00:00:00.000Z" ], [ 47072.025451, 3423, "2025-07-19T00:00:00.000Z" ], [ 88944.657451, 5493, "2025-07-18T00:00:00.000Z" ], [ 84693.2179, 5330, "2025-07-17T00:00:00.000Z" ], [ 74033.329402, 4486, "2025-07-16T00:00:00.000Z" ], [ 45196.658587, 3795, "2025-07-15T00:00:00.000Z" ], [ 51775.958304, 4171, "2025-07-14T00:00:00.000Z" ], [ 21794.68772, 3301, "2025-07-13T00:00:00.000Z" ], [ 12897.454763, 2989, "2025-07-12T00:00:00.000Z" ], [ 28501.331972, 2696, "2025-07-11T00:00:00.000Z" ], [ 9434.839814, 1768, "2025-07-10T00:00:00.000Z" ], [ 1787.583292, 478, "2025-07-09T00:00:00.000Z" ], [ 67.136813, 48, "2025-07-08T00:00:00.000Z" ], [ 2.620556, 5, "2025-07-07T00:00:00.000Z" ], [ 1.577111, 2, "2025-07-06T00:00:00.000Z" ], [ 1.35176, 2, "2025-07-05T00:00:00.000Z" ], [ 1.833145, 4, "2025-07-04T00:00:00.000Z" ], [ 13.709064, 11, "2025-07-03T00:00:00.000Z" ], [ 94.582974, 21, "2025-07-02T00:00:00.000Z" ], [ 11.372761, 15, "2025-07-01T00:00:00.000Z" ], [ 41.631417, 13, "2025-06-30T00:00:00.000Z" ], [ 7.877611, 6, "2025-06-29T00:00:00.000Z" ], [ 7.339948, 9, "2025-06-28T00:00:00.000Z" ], [ 12.068505, 10, "2025-06-27T00:00:00.000Z" ], [ 2.5449, 12, "2025-06-26T00:00:00.000Z" ], [ 10.707844, 12, "2025-06-25T00:00:00.000Z" ], [ 25.642053, 14, "2025-06-24T00:00:00.000Z" ], [ 28.495917, 11, "2025-06-23T00:00:00.000Z" ], [ 33.537211, 11, "2025-06-22T00:00:00.000Z" ], [ 105.558042, 10, "2025-06-21T00:00:00.000Z" ], [ 18.492423, 15, "2025-06-20T00:00:00.000Z" ], [ 43.78534, 13, "2025-06-19T00:00:00.000Z" ], [ 30.926784, 14, "2025-06-18T00:00:00.000Z" ], [ 43.225292, 12, "2025-06-17T00:00:00.000Z" ], [ 10.794542, 14, "2025-06-16T00:00:00.000Z" ], [ 10.452071, 7, "2025-06-15T00:00:00.000Z" ], [ 26.776523, 13, "2025-06-14T00:00:00.000Z" ], [ 10.018504, 14, "2025-06-13T00:00:00.000Z" ], [ 9.121597, 6, "2025-06-12T00:00:00.000Z" ] ] } }, "coinVolumeDistribution": { "24h": { "columns": [ "coin", "volume", "numWallets", "exchangeType" ], "data": [ [ "BTC", 20981682.57748, 1108, "Perp" ], [ "SOL", 9951903.58412, 490, "Perp" ], [ "ETH", 5168278.94634, 350, "Perp" ], [ "xyz:CL", 2180860.510313, 218, "Perp" ], [ "AAVE", 2055558.40642, 36, "Perp" ], [ "xyz:SP500", 1393171.9182, 138, "Perp" ], [ "HYPE", 778460.91085, 157, "Perp" ], [ "TRUMP", 731759.77781, 84, "Perp" ] ] }, "7d": { "columns": [ "coin", "volume", "numWallets", "exchangeType" ], "data": [ [ "BTC", 193035355.78393, 4180, "Perp" ], [ "SOL", 52281197.72599, 1833, "Perp" ], [ "xyz:CL", 35010081.013634, 1448, "Perp" ], [ "ETH", 33986999.03312, 1229, "Perp" ], [ "xyz:BRENTOIL", 18961706.30189, 804, "Perp" ], [ "xyz:SP500", 16425579.2772, 706, "Perp" ], [ "xyz:SILVER", 8405271.46544, 478, "Perp" ], [ "AAVE", 8146600.46467, 230, "Perp" ] ] }, "30d": { "columns": [ "coin", "volume", "numWallets", "exchangeType" ], "data": [ [ "BTC", 1196993599.01215, 10089, "Perp" ], [ "SOL", 341341826.96384, 6099, "Perp" ], [ "xyz:CL", 223211930.200263, 4754, "Perp" ], [ "ETH", 179940730.61972, 3696, "Perp" ], [ "xyz:BRENTOIL", 106064458.83698, 3076, "Perp" ], [ "xyz:SP500", 72739199.2543, 2052, "Perp" ], [ "ZEC", 45598832.1897, 1031, "Perp" ], [ "xyz:SILVER", 36602358.51255, 1648, "Perp" ] ] }, "all": { "columns": [ "coin", "volume", "numWallets", "exchangeType" ], "data": [ [ "BTC", 14326787946.23085, 76343, "Perp" ], [ "SOL", 7542172791.93755, 70360, "Perp" ], [ "ETH", 5556930804.03883, 43042, "Perp" ], [ "XRP", 1283038664.6883, 21074, "Perp" ], [ "ZEC", 927589243.414, 11464, "Perp" ], [ "xyz:SILVER", 890202507.49809, 17377, "Perp" ], [ "HYPE", 644581619.46772, 19658, "Perp" ], [ "xyz:CL", 620982710.745245, 9634, "Perp" ] ] } }, "userVolumeDistribution": { "24h": { "columns": [ "numWallets", "volume", "minVolume", "maxVolume", "percentileGroup" ], "data": [ [ 1386, 509273.595977, 0, 1208.23646, "Rest" ], [ 693, 2039439.606175, 1208.23646, 6210.33604, "25–50%" ], [ 416, 5162968.334824, 6210.33604, 24183.03951720002, "10–25%" ], [ 139, 4941452.62797, 24183.03951720002, 53476.6607872, "5–10%" ], [ 111, 11876318.674626, 53476.6607872, 229539.28078000067, "1–5%" ], [ 28, 25433199.096108, 229539.28078000067, null, "Top 1%" ] ] }, "7d": { "columns": [ "numWallets", "volume", "minVolume", "maxVolume", "percentileGroup" ], "data": [ [ 4338, 2414495.171972, 0, 2068.2873799999998, "Rest" ], [ 2169, 12422829.189896, 2068.2873799999998, 12852.192487, "25–50%" ], [ 1301, 38670505.002335, 12852.192487, 64687.539155000006, "10–25%" ], [ 434, 45970442.038352, 64687.539155000006, 174659.88465325, "5–10%" ], [ 347, 128078442.287047, 174659.88465325, 802022.011095, "1–5%" ], [ 87, 211133256.007956, 802022.011095, null, "Top 1%" ] ] }, "30d": { "columns": [ "numWallets", "volume", "minVolume", "maxVolume", "percentileGroup" ], "data": [ [ 9910, 7255927.068044, 0, 2930.526923, "Rest" ], [ 4955, 45845286.409332, 2930.526923, 22465.29018, "25–50%" ], [ 2973, 169418933.370152, 22465.29018, 128037.63441, "10–25%" ], [ 991, 212440855.766429, 128037.63441, 357370.40782, "5–10%" ], [ 793, 635404452.863539, 357370.40782, 1974426.4326955923, "1–5%" ], [ 199, 1472553898.703863, 1974426.4326955923, null, "Top 1%" ] ] }, "all": { "columns": [ "numWallets", "volume", "minVolume", "maxVolume", "percentileGroup" ], "data": [ [ 65842, 74560913.154533, 0, 4301.4156395, "Rest" ], [ 32921, 433813042.362388, 4301.4156395, 32212.96995375, "25–50%" ], [ 19752, 1738161244.388123, 32212.96995375, 213752.2696045999, "10–25%" ], [ 6584, 2453298175.217567, 213752.2696045999, 641835.5784722489, "5–10%" ], [ 5268, 8498572647.102939, 641835.5784722489, 4417153.628266776, "1–5%" ], [ 1317, 24061523031.7335, 4417153.628266776, null, "Top 1%" ] ] } }, "totalAnalytics": { "1h": { "revenue": 5273.638934, "volume": 10229625.121338, "countUsers": 579 }, "24h": { "revenue": 26447.39295, "volume": 49962651.93568, "countUsers": 2773 }, "7d": { "revenue": 226100.61193399, "volume": 438689969.697558, "countUsers": 8676 }, "30d": { "revenue": 1278057.263787, "volume": 2542919354.181359, "countUsers": 19821 }, "all": { "revenue": 19448375.01427135, "volume": 37259929053.95905, "countUsers": 131684 } }, "totalAnalyticsPrev": { "24h": { "revenue": 18282.696107, "volume": 33973349.451875, "countUsers": 2122 }, "7d": { "revenue": 308291.920369, "volume": 616575362.246966, "countUsers": 10054 }, "30d": { "revenue": 2004214.04612201, "volume": 4007588564.422731, "countUsers": 26136 } }, "numProfitableUsers": { "24h": 1544, "7d": 3843, "30d": 6884, "all": 27186 } } ``` {% endcode %}
*** ### Get Builder Users (Activity & Performance) `/api/external/builders/{builder}/users`
{% hint style="success" %} **Unique to HyperTracker Users** HyperTracker indexes liquidation fills in a structured, queryable format so they can be consumed directly through the API without needing to parse raw on-chain data or maintain custom Hyperliquid infrastructure. {% endhint %} Returns a paginated list of all user wallets that have interacted with a specific builder. A **user** is defined as any wallet that has executed at least one trade (fill) containing the builder’s referral code. Results can be: * **Filtered by timeframe** using the `period` parameter (`24h`, `7d`, `30d`, `all`) * **Sorted dynamically** using `orderBy` and `order` * **Paginated** using `limit` and `offset` This endpoint powers the **Users table** on the Builder Profile page and enables full reconstruction of user-level analytics and rankings.
Path Parameters
ParameterTypeDescription
builderstringThe builder's wallet address.
Query Parameters
ParameterTypeDescription
offsetnumberNumber of results to skip before starting the list.
limitnumberMaximum number of user records to return.
orderstringSorting direction. Allowed values: asc, desc.
orderBystringField to sort by (e.g. pnl, volume, builderFee, equity)
periodstringTimeframe for metrics: 24h, 7d, 30d, all (default: all)
Request Examples {% tabs %} {% tab title="Curl" %} ``` curl -X 'GET' \ 'https://ht-api.coinmarketman.com/api/external/builders/0xb84168cf3be63c6b8dad05ff5d755e97432ff80b/users?limit=10&period=all' \ --header 'Authorization: Bearer YOUR_API_TOKEN' ``` {% endtab %} {% tab title="JavaScript" %} ``` const res = await fetch( 'https://ht-api.coinmarketman.com/api/builders/0x123builder/users?limit=20&orderBy=volume&order=desc', { headers: { Authorization: 'Bearer YOUR_API_TOKEN' } } ); const data = await res.json(); ``` {% endtab %} {% tab title="Python" %} ``` import requests builder = "0x123builder" # replace with the builder address/id from your docs url = f"https://ht-api.coinmarketman.com/api/builders/{builder}/users" params = { "limit": 20, # optional, if your Query Parameters section supports them # "orderBy": "pnl30d", # examples: "pnl24h", "pnl7d", "pnl30d", "pnlAllTime", "equity", "builderFees", "volume" # "order": "desc", # "nextCursor": "..." } headers = { "Authorization": "Bearer YOUR_API_TOKEN", } res = requests.get(url, headers=headers, params=params) res.raise_for_status() data = res.json() print(data) ``` {% endtab %} {% endtabs %} Response > **200 Success:** Returns a paginated list of builder-linked users, including performance metrics, wallet state, and builder attribution data.
Response Examples {% code expandable="true" %} ``` { "items": [ { "perpPnl": -1340201.057585, "pnl": -1343939.010462, "equity": 286309.619538, "address": "0x5a9312c32337a4501c0faa982163ff15e177a0ca", "builderFee": 341907.74077, "volume": 683278744.668884, "closedPnl": -773658.09365, "wallet": { "mid": null, "cmmId": null, "xUserId": null, "displayName": null, "emoji": null, "verified": false, "segments": [ 16, 15 ], "address": "0x5a9312c32337a4501c0faa982163ff15e177a0ca", "favoriteCount": 2, "totalEquity": 286556.532773, "earliestActivityAt": "2026-02-18T22:10:00.125Z", "perpPnl": -1339954.14, "perpEquity": 0, "exposureRatio": null, "perpBias": null, "openValue": 0, "sumUpnl": 0, "vault": null, "closestLiq": { "coin": null, "progress": null } } }, { "perpPnl": -2290593.132955, "pnl": -2292730.968397, "equity": 255.561603, "address": "0x1aa6a90f54dfaa5aa876b4fb34c7207340f9e60b", "builderFee": 241462.472146, "volume": 482924997.150259, "closedPnl": 1827353.198027, "wallet": { "mid": null, "cmmId": null, "xUserId": null, "displayName": null, "emoji": null, "verified": false, "segments": [ 1, 15 ], "address": "0x1aa6a90f54dfaa5aa876b4fb34c7207340f9e60b", "favoriteCount": 1, "totalEquity": 255.561604, "earliestActivityAt": "2025-08-13T22:48:00.045Z", "perpPnl": -2290593.132955, "perpEquity": 255.507045, "exposureRatio": 0, "perpBias": null, "openValue": 0, "sumUpnl": 0, "vault": null, "closestLiq": { "coin": null, "progress": null } } }, { "perpPnl": -444700.78681, "pnl": -462625.105184, "equity": 58.814816, "address": "0xc8514c208a71ee7f7b84743f5725b7217885adf9", "builderFee": 193734.71275, "volume": 387469434.280894, "closedPnl": 561199.226791, "wallet": { "mid": null, "cmmId": null, "xUserId": null, "displayName": null, "emoji": null, "verified": false, "segments": [ 16, 14 ], "address": "0xc8514c208a71ee7f7b84743f5725b7217885adf9", "favoriteCount": 1, "totalEquity": 58.831247, "earliestActivityAt": "2025-07-23T22:24:00.048Z", "perpPnl": -444700.78681, "perpEquity": 0.00319, "exposureRatio": 0, "perpBias": null, "openValue": 0, "sumUpnl": 0, "vault": null, "closestLiq": { "coin": null, "progress": null } } }, { "perpPnl": -492833.286678, "pnl": -494517.945164, "equity": 174.164836, "address": "0x6f4cbb7f00f8bb02593a0b4703d0f1e2d6573c04", "builderFee": 161939.950896, "volume": 323879907.8566, "closedPnl": -156458.995559, "wallet": { "mid": null, "cmmId": null, "xUserId": null, "displayName": null, "emoji": null, "verified": false, "segments": [ 16, 14 ], "address": "0x6f4cbb7f00f8bb02593a0b4703d0f1e2d6573c04", "favoriteCount": 0, "totalEquity": 174.164836, "earliestActivityAt": "2025-07-30T22:28:00.044Z", "perpPnl": -492833.286678, "perpEquity": 0.003322, "exposureRatio": 0, "perpBias": null, "openValue": null, "sumUpnl": null, "vault": null, "closestLiq": { "coin": null, "progress": null } } }, { "perpPnl": -544992.3, "pnl": -545300.517383, "equity": 3.872617, "address": "0x1ecc2ead824c571e9bafd7b62cea9b53a8f8a0c5", "builderFee": 151179.61051, "volume": 302359234.53503, "closedPnl": 323303.857786, "wallet": { "mid": null, "cmmId": null, "xUserId": null, "displayName": null, "emoji": null, "verified": false, "segments": [ 16, 14 ], "address": "0x1ecc2ead824c571e9bafd7b62cea9b53a8f8a0c5", "favoriteCount": 1, "totalEquity": 3.965268, "earliestActivityAt": "2025-10-29T21:20:00.043Z", "perpPnl": -544992.3, "perpEquity": 0, "exposureRatio": null, "perpBias": null, "openValue": 0, "sumUpnl": 0, "vault": null, "closestLiq": { "coin": null, "progress": null } } }, { "perpPnl": -287161.172991, "pnl": -287700.875246, "equity": 0.134754, "address": "0x2768a6370ec214e21fecdf8e72bc806663eabca3", "builderFee": 140288.936709, "volume": 280577887.767136, "closedPnl": 213040.204936, "wallet": { "mid": null, "cmmId": null, "xUserId": null, "displayName": null, "emoji": null, "verified": false, "segments": [ 16, 14 ], "address": "0x2768a6370ec214e21fecdf8e72bc806663eabca3", "favoriteCount": 0, "totalEquity": 0.137038, "earliestActivityAt": "2025-07-16T21:26:00.064Z", "perpPnl": -287161.172991, "perpEquity": 0.007009, "exposureRatio": 0, "perpBias": null, "openValue": 0, "sumUpnl": 0, "vault": null, "closestLiq": { "coin": null, "progress": null } } }, { "perpPnl": -788642.716411, "pnl": -794557.200214, "equity": 205081.289786, "address": "0xe9c888b87f2c8723a08d105a18bcd5cbb101770f", "builderFee": 136808.412158, "volume": 273616860.836831, "closedPnl": -396440.906741, "wallet": { "mid": null, "cmmId": null, "xUserId": null, "displayName": null, "emoji": null, "verified": false, "segments": [ 4, 14 ], "address": "0xe9c888b87f2c8723a08d105a18bcd5cbb101770f", "favoriteCount": 0, "totalEquity": 205081.289786, "earliestActivityAt": "2025-09-24T20:52:00.066Z", "perpPnl": -788642.716411, "perpEquity": 199144.177234, "exposureRatio": 1.58, "perpBias": 1.58, "openValue": 314377.45703, "sumUpnl": 3749.391683, "vault": null, "closestLiq": { "coin": "SOL", "progress": 0 } } }, { "perpPnl": -1259268.549073, "pnl": -1262182.779703, "equity": 0.200297, "address": "0x21df9d2f980150dad8849a4ea5b713c3c2752db1", "builderFee": 132474.37926, "volume": 264948769.997494, "closedPnl": 665339.936418, "wallet": { "mid": null, "cmmId": null, "xUserId": null, "displayName": null, "emoji": null, "verified": false, "segments": [ 16, 15 ], "address": "0x21df9d2f980150dad8849a4ea5b713c3c2752db1", "favoriteCount": 1, "totalEquity": 0.20428, "earliestActivityAt": "2025-08-13T21:54:00.047Z", "perpPnl": -1259268.549073, "perpEquity": 0.000927, "exposureRatio": 0, "perpBias": null, "openValue": 0, "sumUpnl": 0, "vault": null, "closestLiq": { "coin": null, "progress": null } } }, { "perpPnl": -518311.337937, "pnl": -518742.909624, "equity": 8346.200376, "address": "0x5eadc60e27b8608991648fee36d01f3e55a3cf7e", "builderFee": 130439.463475, "volume": 260814560.207543, "closedPnl": 525412.49393, "wallet": { "mid": null, "cmmId": null, "xUserId": null, "displayName": null, "emoji": null, "verified": false, "segments": [ 1, 14 ], "address": "0x5eadc60e27b8608991648fee36d01f3e55a3cf7e", "favoriteCount": 0, "totalEquity": 8165.339961, "earliestActivityAt": "2025-07-30T21:14:00.029Z", "perpPnl": -519218.352447, "perpEquity": 8165.331647, "exposureRatio": 11.08, "perpBias": -11.08, "openValue": 90456.91263, "sumUpnl": -999.58716, "vault": null, "closestLiq": { "coin": "xyz:AMD", "progress": 23.99 } } }, { "perpPnl": -101566.12, "pnl": -101900.093417, "equity": 0.206583, "address": "0x461936e2d4055a76d9739723f924600ea575433e", "builderFee": 119745.928774, "volume": 239491869.67866, "closedPnl": 292624.622955, "wallet": { "mid": null, "cmmId": null, "xUserId": null, "displayName": null, "emoji": null, "verified": false, "segments": [ 16, 14 ], "address": "0x461936e2d4055a76d9739723f924600ea575433e", "favoriteCount": 0, "totalEquity": 0.211145, "earliestActivityAt": "2025-07-30T22:44:00.031Z", "perpPnl": -101566.12, "perpEquity": 0, "exposureRatio": null, "perpBias": null, "openValue": 0, "sumUpnl": 0, "vault": null, "closestLiq": { "coin": null, "progress": null } } } ], "totalCount": 131687 } ``` {% endcode %}
*** ### Get Builder Fills `/api/external/builders/{builder}/fills` {% hint style="success" %} **Unique to HyperTracker Users** This endpoint provides builder-filtered fill data, allowing you to retrieve executions tied to a specific builder address. HyperTracker curates this by tracking fills with builder attribution, making it possible to analyse builder-driven trading activity directly. {% endhint %} Returns trade fills associated with a specific builder address. Each fill represents a single matched execution routed through that builder and includes the user wallet address, traded coin, execution price and size, side, timestamp, position impact, closed PnL, fee data, builder fee, order ID, trade ID, transaction hash, and whether the execution crossed the spread. Use this endpoint to analyse raw trading activity generated through a builder, audit builder fee attribution, reconstruct execution-level user activity, or power builder-specific fills tables. This endpoint supports filtering by coin, user address, fill type, side, and time window. Results are paginated using `nextCursor`. Important: `start` is required, and the queried window is limited to one calendar day. If `end` is omitted, the API uses the current time. All data fully available from July 2025. TWAPs are listed with the address "0x0000000000000000000000000000000000000000000000000000000000000000".
Query Parameters
ParameterTypeDescription
limitnumberMaximum number of fills to return in one response.
coinarray[string]Filter by one or more coin symbols, e.g. BTC, ETH, xyz:NVDA.
nextCursorstringCursor for pagination. Use the nextCursor value from the previous response to fetch the next page.
addressarray[string]Filter by one or more user wallet addresses.
fillTypestringFilter by fill type, e.g. perp.
startstringStart of the time window in ISO 8601 format. Required.
endstringEnd of the time window in ISO 8601 format. Must be within the same calendar day as start. If omitted, defaults to now.
sidestringFilter by fill side. Allowed values: A, B.
Request Examples {% tabs %} {% tab title="Curl" %} ``` curl --request GET \ --url 'https://ht-api.coinmarketman.com/api/external/builders/0xb84168cf3be63c6b8dad05ff5d755e97432ff80b/fills?limit=10&start=2026-04-20T18%3A27%3A00.781Z' \ --header 'Authorization: Bearer YOUR_API_TOKEN' ``` {% endtab %} {% tab title="Python" %} ``` import requests response = requests.get( 'https://ht-api.coinmarketman.com/api/external/fills', params={ 'limit': 50, 'start': '2026-02-15T00:00:00.000Z', 'end': '2026-02-15T23:59:59.999Z', 'coin': ['BTC', 'ETH'] }, headers={'Authorization': 'Bearer YOUR_API_TOKEN'} ) fills = response.json() ``` {% endtab %} {% endtabs %} Response > **200 Success:** Returns builder-attributed fills matching the selected filters, plus a nextCursor value when more results are available.
Response Example {% code expandable="true" %} ``` { "fills": [ { "oid": 389801371337, "address": "0x81b5721d7ceb7b8b55421c5dfdb4bc2b8bbd2130", "coin": "xyz:BRENTOIL", "fullCoinName": "xyz:BRENTOIL", "fillType": "perp", "px": 90.27, "sz": 0.32, "side": "A", "time": "2026-04-20T18:27:12.361Z", "startPosition": 0.32, "dir": "Close Long", "closedPnl": -0.942144, "hash": "0x037736783fdbe63704f004399836af020232005ddadf0509a73fe1cafedfc021", "crossed": true, "fee": 0.016938, "builderFee": 0.014443, "tid": 181989667342253, "feeToken": "USDC", "builder": "0xb84168cf3be63c6b8dad05ff5d755e97432ff80b" }, { "oid": 389297914770, "address": "0x4186a38de62dc25c98a6341d2277b90299032c6c", "coin": "xyz:NVDA", "fullCoinName": "xyz:NVDA", "fillType": "perp", "px": 200.77, "sz": 0.611, "side": "B", "time": "2026-04-20T18:27:13.529Z", "startPosition": -0.611, "dir": "Close Short", "closedPnl": -0.6721, "hash": "0x58019106aba69d17597b04399836bf0202a700ec46a9bbe9fbca3c596aaa7701", "crossed": true, "fee": 0.071933, "builderFee": 0.061335, "tid": 1086519591401350, "feeToken": "USDC", "builder": "0xb84168cf3be63c6b8dad05ff5d755e97432ff80b" }, { "oid": 389801536441, "address": "0x81b5721d7ceb7b8b55421c5dfdb4bc2b8bbd2130", "coin": "VVV", "fullCoinName": "VVV", "fillType": "perp", "px": 9.3917, "sz": 2.85, "side": "B", "time": "2026-04-20T18:27:21.765Z", "startPosition": 11.36, "dir": "Open Long", "closedPnl": 0, "hash": "0x7ea920258f78066b8022043998373a020145000b2a7b253d2271cb784e7be056", "crossed": true, "fee": 0.024946, "builderFee": 0.013383, "tid": 934644768392386, "feeToken": "USDC", "builder": "0xb84168cf3be63c6b8dad05ff5d755e97432ff80b" }, { "oid": 389801539321, "address": "0x8dc5ecd72a4ed6015316998e107567e39a2e1ee2", "coin": "BTC", "fullCoinName": "BTC", "fillType": "perp", "px": 76078, "sz": 0.00452, "side": "A", "time": "2026-04-20T18:27:22.036Z", "startPosition": 0, "dir": "Open Short", "closedPnl": 0, "hash": "0xe39abcfd930f79a2e514043998373e0201d200e32e029874876368505203538d", "crossed": true, "fee": 0.320488, "builderFee": 0.171936, "tid": 519868954716543, "feeToken": "USDC", "builder": "0xb84168cf3be63c6b8dad05ff5d755e97432ff80b" }, { "oid": 389801552178, "address": "0x66219737394e4761a6fb9a65642a21aa05ef698e", "coin": "BTC", "fullCoinName": "BTC", "fillType": "perp", "px": 76079, "sz": 0.00502, "side": "B", "time": "2026-04-20T18:27:23.065Z", "startPosition": 0, "dir": "Open Long", "closedPnl": 0, "hash": "0x3f77e71fd0e7d41340f1043998374c02029a00056beaf2e5e34092728febadfd", "crossed": true, "fee": 0.355945, "builderFee": 0.190958, "tid": 73995606143591, "feeToken": "USDC", "builder": "0xb84168cf3be63c6b8dad05ff5d755e97432ff80b" }, { "oid": 389801580782, "address": "0x5e2ee90225ce5b3378be54473505126dc4864a5d", "coin": "BTC", "fullCoinName": "BTC", "fillType": "perp", "px": 76078, "sz": 0.01653, "side": "A", "time": "2026-04-20T18:27:25.736Z", "startPosition": -0.44219, "dir": "Open Short", "closedPnl": 0, "hash": "0xe58669ab2e19e025e70004399837730203e20090c91cfef7894f14fded1dba10", "crossed": true, "fee": 1.172053, "builderFee": 0.628784, "tid": 1112294120691279, "feeToken": "USDC", "builder": "0xb84168cf3be63c6b8dad05ff5d755e97432ff80b" }, { "oid": 389801580782, "address": "0x5e2ee90225ce5b3378be54473505126dc4864a5d", "coin": "BTC", "fullCoinName": "BTC", "fillType": "perp", "px": 76078, "sz": 0.05009, "side": "A", "time": "2026-04-20T18:27:25.736Z", "startPosition": -0.3921, "dir": "Open Short", "closedPnl": 0, "hash": "0xe58669ab2e19e025e70004399837730203e20090c91cfef7894f14fded1dba10", "crossed": true, "fee": 3.551615, "builderFee": 1.905373, "tid": 264442611831910, "feeToken": "USDC", "builder": "0xb84168cf3be63c6b8dad05ff5d755e97432ff80b" }, { "oid": 389801587921, "address": "0x18ec53e6bc28375ac242d702bb8011a6d431c955", "coin": "SOL", "fullCoinName": "SOL", "fillType": "perp", "px": 86, "sz": 7.92, "side": "A", "time": "2026-04-20T18:27:26.290Z", "startPosition": -119.95, "dir": "Open Short", "closedPnl": 0, "hash": "0xda3ffc45bebdb24edbb9043998377b020154002b59b0d1207e08a7987db18c39", "crossed": true, "fee": 0.634803, "builderFee": 0.34056, "tid": 594337270287395, "feeToken": "USDC", "builder": "0xb84168cf3be63c6b8dad05ff5d755e97432ff80b" }, { "oid": 389801649537, "address": "0x3a162b8206ff2836af5ebd2fe84926ba98815707", "coin": "ETH", "fullCoinName": "ETH", "fillType": "perp", "px": 2327.1, "sz": 0.0838, "side": "B", "time": "2026-04-20T18:27:32.059Z", "startPosition": 0, "dir": "Open Long", "closedPnl": 0, "hash": "0x36cf453bc42cdc97384904399837cf02041f00215f2ffb69da97f08e8320b681", "crossed": true, "fee": 0.181749, "builderFee": 0.097505, "tid": 305784116769290, "feeToken": "USDC", "builder": "0xb84168cf3be63c6b8dad05ff5d755e97432ff80b" }, { "oid": 389801649537, "address": "0x3a162b8206ff2836af5ebd2fe84926ba98815707", "coin": "ETH", "fullCoinName": "ETH", "fillType": "perp", "px": 2327.2, "sz": 0.0065, "side": "B", "time": "2026-04-20T18:27:32.059Z", "startPosition": 0.0838, "dir": "Open Long", "closedPnl": 0, "hash": "0x36cf453bc42cdc97384904399837cf02041f00215f2ffb69da97f08e8320b681", "crossed": true, "fee": 0.014097, "builderFee": 0.007563, "tid": 627880721983248, "feeToken": "USDC", "builder": "0xb84168cf3be63c6b8dad05ff5d755e97432ff80b" } ], "nextCursor": "eyJvaWQiOjM4OTgwMTY0OTUzNywidGltZSI6MTc3NjcwOTY1MjA1OSwic3RhcnRQb3NpdGlvbiI6MC4wODM4fQ.2abOaeJVlOh6DKqhH0HNM9Hp_WBH-0q13MEB4lrAzCw" } ``` {% endcode %}
*** ### Get Builder Ecosystem Revenue & Users (Daily Time Series) `/api/external/builders/all-time-revenue`
{% hint style="success" %} **Unique to HyperTracker Users** {% endhint %} Returns a daily time-series of aggregated builder activity across the entire ecosystem. Each row represents one calendar day and includes: * Total builder fee revenue * Number of unique users generating that revenue This dataset powers the Total Revenue, Daily Revenue, and Unique Users charts on the Live Builder Analytics page and spans from the earliest recorded activity through to the current day. All-time revenue can be calculated by summing the `revenue` column across all rows. Request Examples {% tabs %} {% tab title="Curl" %} ``` curl -X GET \ 'https://ht-api.coinmarketman.com/api/external/builders/all-time-revenue' \ -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/builders/all-time-revenue", headers={ "accept": "application/json", "Authorization": "Bearer YOUR_API_TOKEN", }, ) result = response.json() ``` {% endtab %} {% endtabs %} Response > **200 Success:** Returns a daily columnar time-series of total builder revenue and unique users across the ecosystem.
Response Example {% code expandable="true" %} ``` { "columns": [ "revenue", "timestamp", "countUsers" ], "data": [ [ 44570.91954633, "2026-04-27T00:00:00.000Z", 8744 ], [ 84154.902394, "2026-04-26T00:00:00.000Z", 13646 ], [ 68405.74977925, "2026-04-25T00:00:00.000Z", 12038 ], [ 149807.94453344, "2026-04-24T00:00:00.000Z", 17323 ], [ 160231.96078903, "2026-04-23T00:00:00.000Z", 18955 ], [ 170267.07612118, "2026-04-22T00:00:00.000Z", 20053 ], [ 189947.32971233, "2026-04-21T00:00:00.000Z", 17228 ], [ 158567.33505205, "2026-04-20T00:00:00.000Z", 16938 ], [ 158839.33120708, "2026-04-19T00:00:00.000Z", 16269 ], [ 133375.50090738, "2026-04-18T00:00:00.000Z", 15308 ], [ 245560.15105072, "2026-04-17T00:00:00.000Z", 19859 ], [ 190724.73547685, "2026-04-16T00:00:00.000Z", 17703 ], [ 147002.2800245, "2026-04-15T00:00:00.000Z", 15942 ], [ 199595.76338803, "2026-04-14T00:00:00.000Z", 18820 ], [ 186113.67812519, "2026-04-13T00:00:00.000Z", 17635 ], [ 192177.88970061, "2026-04-12T00:00:00.000Z", 15813 ], [ 122127.88470554, "2026-04-11T00:00:00.000Z", 12890 ], ``` {% endcode %}
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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/builder-analytics.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.