🏗️Builder Analytics

The Builder Analytics endpoints provide insights into builder activity and performance across the platform. Use them to fetch detailed analytics for builders, including engagement and performance metrics, both globally and for the authenticated user. These endpoints are designed for powering builder dashboards, monitoring growth over time, and analyzing which builders are driving the most impact.

Unique to HyperTracker Users

This endpoint is exclusive to HyperTracker, which independently aggregates and delivers this data beyond what’s available in the standard Hyperliquid API.

Get All Builders

/api/external/builders/list/timeframe/{timeframe}

Returns the full Builders table on the Builders page. Each row in that table corresponds to one entry in this response: a ranked list of all builders on the Hyperliquid network for the selected timeframe, ordered by revenue descending. Each entry includes the builder's display name, wallet address, fee rate, user count, volume, and total revenue for the specified period.

Path Parameters

Parameter	Type	Description
timeframe	string	Time period for builder statistics. Available values: 24h, 7d, 30d, all

Request Examples

Curl

curl -X GET \
  'https://ht-api.coinmarketman.com/api/external/builders/list/timeframe/7d' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Python

Response

200 Success: Returns a builders array containing all active builders on the network, sorted by revenue descending for the requested timeframe.

Response Examples

{
  "builders": [
    {
      "refCode": "Phantom",
      "address": "0xb84168cf3be63c6b8dad05ff5d755e97432ff80b",
      "revenue": 17241054.054442,
      "timeJoined": "2025-06-11T22:48:00.027Z",
      "createdAt": "2025-07-02T14:47:33.000Z",
      "usageFee": 0.0004999987944462861,
      "users": 121714,
      "volume": 32869400819.47795
    },
    {
      "refCode": "Based",
      "address": "0x1924b8561eef20e70ede628a296175d358be80e5",
      "revenue": 14068351.026812,
      "timeJoined": "2025-06-11T20:44:00.135Z",
      "createdAt": "2025-07-02T14:47:30.000Z",
      "usageFee": 0.0008,
      "users": 41252,
      "volume": 40606299303.83281
    },
    {
      "refCode": null,
      "address": "0x90c8737fcc9d607b15e718eaf9c4465fb2436d32",
      "revenue": 168711.932413,
      "timeJoined": "2025-07-30T22:40:00.011Z",
      "createdAt": "2025-07-25T22:22:43.000Z",
      "usageFee": 0.0002999563461748336,
      "users": 105,
      "volume": 394587758.984621
    }
  ]
}

---

Unique to HyperTracker Users

This endpoint is exclusive to HyperTracker, which independently aggregates and delivers this data beyond what’s available in the standard Hyperliquid API.

Get Builder Profile

/api/external/builders/{builder}/profile

Returns a comprehensive profile for a specific builder address. This includes identity metadata (name, URL, social links), lifetime and period-based revenue totals, the builder's fee rate, their single biggest revenue day, progress toward revenue milestones, and a full breakdown of analytics and volume distribution across 24h, 7d, 30d, and all-time windows.

Path Parameters

Parameter	Type	Description
builder	string	The builder's wallet address.

Request Examples

Curl

curl -X GET \
  'https://ht-api.coinmarketman.com/api/external/builders/{builder}/profile' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Python

Response

200 Success: Returns the full profile for the requested builder address.

Response Examples

{
  "info": {
    "address": "0xb5d19a1f92fcd5bfdd154d16793bb394f246cb36",
    "code": null,
    "name": null,
    "url": null,
    "xUrl": null,
    "xUserId": null,
    "xUser": null,
    "firstActivityAt": "2025-11-26T22:31:28.463Z",
    "revenue": 3716.584518
  },
  "hyperliquidVolume24h": 4600524044.736472,
  "fee": 0.00009999889125509134,
  "biggestDay": {
    "revenue": 233.501533,
    "date": "2025-11-28T00:00:00.000Z"
  },
  "revenueMilestones": [
    {
      "revenue": 10000,
      "label": "10k",
      "done": false,
      "date": null
    },
    {
      "label": "100k",
      "revenue": 100000,
      "done": false,
      "date": null
    }
  ],
  "analytics": {
    "24h": {
      "columns": ["revenue", "users", "timestamp"],
      "data": [
        [0.149779, 1, "2026-03-12T10:00:00.000Z"],
        [0.021057, 1, "2026-03-12T08:00:00.000Z"],
        [0.199872, 1, "2026-03-12T06:00:00.000Z"]
      ]
    },
    "7d": {
      "columns": ["revenue", "users", "timestamp"],
      "data": [
        [0.412926, 3, "2026-03-12T00:00:00.000Z"],
        [0.638586, 2, "2026-03-11T00:00:00.000Z"],
        [3.662319, 2, "2026-03-10T00:00:00.000Z"]
      ]
    },
    "30d": {
      "columns": ["revenue", "users", "timestamp"],
      "data": [
        [0.412926, 3, "2026-03-12T00:00:00.000Z"],
        [0.638586, 2, "2026-03-11T00:00:00.000Z"],
        [3.662319, 2, "2026-03-10T00:00:00.000Z"]
      ]
    },
    "all": {
      "columns": ["revenue", "users", "timestamp"],
      "data": [
        [0.412926, 3, "2026-03-12T00:00:00.000Z"],
        [233.501533, 15, "2025-11-28T00:00:00.000Z"],
        [84.44657, 1, "2025-11-26T00:00:00.000Z"]
      ]
    }
  },
  "coinVolumeDistribution": {
    "24h": {
      "columns": ["coin", "volume", "numWallets", "exchangeType"],
      "data": [
        ["xyz:XYZ100", 1998.7496, 1, "Perp"],
        ["xyz:SILVER", 1497.82612, 1, "Perp"],
        ["xyz:CRCL", 632.76995, 1, "Perp"],
        ["xyz:BRENTOIL", 514.76102, 1, "Perp"]
      ]
    },
    "7d": {
      "columns": ["coin", "volume", "numWallets", "exchangeType"],
      "data": [
        ["xyz:SILVER", 183192.26522, 4, "Perp"],
        ["xyz:XYZ100", 33971.1882, 1, "Perp"],
        ["xyz:BRENTOIL", 30026.88588, 3, "Perp"]
      ]
    },
    "30d": {
      "columns": ["coin", "volume", "numWallets", "exchangeType"],
      "data": [
        ["xyz:XYZ100", 3061018.361, 6, "Perp"],
        ["xyz:SILVER", 636507.07633, 7, "Perp"],
        ["xyz:BRENTOIL", 30026.88588, 3, "Perp"]
      ]
    },
    "all": {
      "columns": ["coin", "volume", "numWallets", "exchangeType"],
      "data": [
        ["xyz:XYZ100", 67382918.6666, 52, "Perp"],
        ["xyz:SILVER", 1664701.05903, 11, "Perp"],
        ["xyz:TSLA", 708527.47105, 6, "Perp"]
      ]
    }
  },
  "userVolumeDistribution": {
    "24h": {
      "columns": ["numWallets", "volume", "minVolume", "maxVolume", "percentileGroup"],
      "data": [
        [1, 1147.53097, 0, 1497.82612, "Rest"],
        [1, 1497.82612, 1497.82612, 1748.28786, "25–50%"],
        [1, 1998.7496, 1988.7311304, null, "Top 1%"]
      ]
    },
    "7d": {
      "columns": ["numWallets", "volume", "minVolume", "maxVolume", "percentileGroup"],
      "data": [
        [3, 29678.13815, 0, 33971.1882, "Rest"],
        [2, 68115.19402, 33971.1882, 56414.030255000005, "25–50%"],
        [1, 78684.05469, 56414.030255000005, 89626.35555520002, "10–25%"],
        [1, 106039.806853, 104398.46172321998, null, "Top 1%"]
      ]
    },
    "30d": {
      "columns": ["numWallets", "volume", "minVolume", "maxVolume", "percentileGroup"],
      "data": [
        [6, 73445.61176, 0, 41937.731035000004, "Rest"],
        [3, 911643.826843, 41937.731035000004, 615167.1147475, "25–50%"],
        [1, 784097.41129, 615167.1147475, 885555.3134320001, "10–25%"],
        [1, 896828.41367, 885555.3134320001, 1003942.8359431999, "5–10%"],
        [1, 1134860.463166, 1108676.93772144, null, "Top 1%"]
      ]
    },
    "all": {
      "columns": ["numWallets", "volume", "minVolume", "maxVolume", "percentileGroup"],
      "data": [
        [30, 3114353.60591, 0, 364984.63635, "Rest"],
        [15, 9117343.284319, 364984.63635, 1150257.8838245, "25–50%"],
        [9, 17433528.10142, 1150257.8838245, 3924129.1537890006, "10–25%"],
        [3, 14556353.0387, 3924129.1537890006, 5836774.578593994, "5–10%"],
        [2, 16046599.58684, 5836774.578593994, 9267142.783315292, "1–5%"],
        [1, 10814916.72173, 9267142.783315292, null, "Top 1%"]
      ]
    }
  },
  "totalAnalytics": {
    "1h": {
      "revenue": null,
      "volume": null,
      "countUsers": 0
    },
    "24h": {
      "revenue": 0.464402,
      "volume": 4644.10669,
      "countUsers": 3
    },
    "7d": {
      "revenue": 28.251355,
      "volume": 282517.193713,
      "countUsers": 7
    },
    "30d": {
      "revenue": 214.791567,
      "volume": 3800875.726729,
      "countUsers": 12
    },
    "all": {
      "revenue": 3716.584518,
      "volume": 71083094.338919,
      "countUsers": 60
    }
  },
  "totalAnalyticsPrev": {
    "24h": {
      "revenue": 1.911181,
      "volume": 19111.97172,
      "countUsers": 3
    },
    "7d": {
      "revenue": 55.870012,
      "volume": 1104458.81086,
      "countUsers": 8
    },
    "30d": {
      "revenue": 681.672373,
      "volume": 13633690.14472,
      "countUsers": 20
    }
  },
  "numProfitableUsers": {
    "24h": 1,
    "7d": 3,
    "30d": 5,
    "all": 15
  }
}

---

Get Builder’s Users and Activity

/api/external/builders/{builder}/users

Shows all users who are connected to a specific builder and reveals both their engagement and their trading performance. You can see each user’s address, equity, recent profit and loss over the last 24 hours, 7 days, 30 days or all-time, how much they have paid in builder fees, and the total trading volume they have generated. It also includes profile information when available, like display name or social details, plus basic activity such as how long the account has been active.

The endpoint can return up to 1,000 results per request. Lower limits usually result in faster response times.

Path Parameters

Parameter	Type	Description
builder	string	The builder's wallet address.

Query Parameters

Parameter	Type	Description
offset	number	Number of results to skip before starting the list.
limit	number	Maximum number of user records to return.
order	string	Sorting direction. Allowed values: asc, desc.
orderBy	string	Field to order results by (e.g. createdAt, trades, volume).
period	string	Period to show results for (available: 24h, 7d, 30d, all. Default value is "all").

Request Examples

Curl

curl --request GET \
  --url 'https://ht-api.coinmarketman.com/api/builders/0x123builder/users?limit=20&orderBy=volume&order=desc' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'

JavaScript

Python

Response

200 Success: Returns builder user activity data.

Response Examples

{
  "totalCount": 1,
  "items": [
    {
      "builderFee": 300.75,
      "volume": 300.75,
      "equity": 300.75,
      "closedPnl": 300.75,
      "perpPnl": 300.75,
      "pnl": 300.75,
      "wallet": {
        "mid": 100,
        "cmmId": 100,
        "segments": [
          1,
          2,
          3
        ],
        "address": "0x123abc...",
        "totalEquity": 10000.5,
        "perpEquity": 8000.25,
        "perpBias": 0.6,
        "exposureRatio": 0.6,
        "openValue": 5000,
        "sumUpnl": 120.5,
        "perpPnl": 300.75,
        "earliestActivityAt": "2024-01-01T12:00:00Z",
        "closestLiq": {
          "coin": "BTC",
          "progress": 0.78
        },
        "emoji": "🎸",
        "displayName": "Cobie",
        "verified": true,
        "xUser": {
          "xUserId": "1234567890",
          "screenName": "elonmusk",
          "name": "Elon Musk",
          "verified": true,
          "profileImageUrl": "https://pbs.twimg.com/profile_images/1234567890/abc_normal.jpg",
          "followersCount": 150000000,
          "followingCount": 100
        },
        "vault": {
          "leader": "0x1234567890abcdef1234567890abcdef12345678",
          "name": "My Awesome Vault",
          "description": "This vault is focused on long-term investments in crypto assets."
        },
        "favorite": {
          "favorite": false,
          "displayName": "Gaspedal",
          "emoji": "string",
          "featured": true
        }
      }
    }
  ]
}

---

Unique to HyperTracker Users

This endpoint is exclusive to HyperTracker, which independently aggregates and delivers this data beyond what’s available in the standard Hyperliquid API.

Get Builder Fills

/api/external/fills

Returns trade fills (executions) within a selected time window for the requested filters. Each fill represents a single matched execution and includes the wallet address, traded symbol, execution price and size, side (B buy or A sell), execution timestamp, and position impact (the position before the fill and whether it opened or closed long or short exposure). It also provides execution identifiers (order id and trade id), whether the execution crossed the spread, the transaction hash when available, and all fee attribution including fee amount, fee token, optional builder address, and builder fee.

This endpoint can only be queried one day at a time: end must be within the same calendar day as start. All data fully available from July 2025. TWAPs are listed with the address "0x0000000000000000000000000000000000000000000000000000000000000000".

Query Parameters

Parameter	Type	Description
limit	number	Maximum number of metric rows to return in one response.
coin	string	Filter by one or more coin symbols (for example ETH, BTC).
nextCursor	string	Cursor for pagination. Use the nextCursor value from the previous response to fetch the next page.
address	string	Filter by one or more wallet addresses.
builder	string	Filter by one or more builder addresses.
start	string	Start of the time window (ISO8601).
end	string	End of the time window (ISO 8601, UTC). If omitted, the API uses “now”.
side	string	Filter by fill side. Allowed values: A, B.

Request Examples

Curl

curl --request GET \
  --url 'https://ht-api.coinmarketman.com/api/external/fills?limit=50&start=2026-02-15T00%3A00%3A00.000Z&end=2026-02-15T23%3A59%3A59.999Z&coin=BTC&coin=ETH' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'

Python

Response

200 Success: Returns a list of fills that match the provided filters.

Response Example

{
  "fills": [
    {
      "oid": 321047567143,
      "address": "0x0f0d9105b88e938df7816b23e7ad4d1660568a0e",
      "coin": "ASTER",
      "fullCoinName": "ASTER",
      "fillType": "perp",
      "px": 0.7221,
      "sz": 991,
      "side": "B",
      "time": "2026-02-15T00:49:49.991Z",
      "startPosition": -440748,
      "dir": "Close Short",
      "hash": "0x1ee4dd3e00aeba63205e0435523eda0204b000239ba1d935c2ad8890bfa2944d",
      "crossed": false,
      "fee": 0.068697,
      "builderFee": 0,
      "tid": 869001364256271,
      "feeToken": "USDC",
      "builder": ""
    },
    {
      "oid": 321047295912,
      "address": "0x31dea2516beee92135b96f464eeec3cf292a13f2",
      "coin": "BTC",
      "fullCoinName": "BTC",
      "fillType": "perp",
      "px": 69628,
      "sz": 0.00036,
      "side": "A",
      "time": "2026-02-15T00:49:50.084Z",
      "startPosition": -4.7052,
      "dir": "Open Short",
      "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
      "crossed": false,
      "fee": -0.00025,
      "builderFee": 0,
      "tid": 137398928014387,
      "feeToken": "USDC",
      "builder": ""
    },
    {
      "oid": 321047571710,
      "address": "0x4b1d33556b6b21f11242c905d187f951e76241f4",
      "coin": "BTC",
      "fullCoinName": "BTC",
      "fillType": "perp",
      "px": 69628,
      "sz": 0.00036,
      "side": "B",
      "time": "2026-02-15T00:49:50.084Z",
      "startPosition": 0.28398,
      "dir": "Open Long",
      "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
      "crossed": true,
      "fee": 0.011279,
      "builderFee": 0,
      "tid": 137398928014387,
      "feeToken": "USDC",
      "builder": ""
    }
  ],
  "nextCursor": "string"
}

---

Unique to HyperTracker Users

This endpoint is exclusive to HyperTracker, which independently aggregates and delivers this data beyond what’s available in the standard Hyperliquid API.

Get Builders All-Time Revenue, Daily Revenue and Users

/api/external/builders/all-time-revenue

Returns the data powering the Total Revenue, Daily Revenue, and Unique Users charts on the HyperTracker Live Builder Analytics page. Each row covers one calendar day and includes two metrics: the total builder fees collected across the entire Hyperliquid ecosystem, and the number of distinct users who generated those fees. The series runs from the earliest recorded date through to the current day.

To calculate all-time total revenue, sum the revenue field across all rows in the response. This is the same figure shown in the Total Revenue chart on the Live Builder Analytics page.

Request Examples

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'

Python

Response

200 Success: Returns a columnar time-series object covering all recorded days of builder revenue activity.

Response Example

{
  "columns": [
    "revenue",
    "timestamp",
    "countUsers"
  ],
  "data": [
    [
      115218.44242235,
      "2026-03-12T00:00:00.000Z",
      11935
    ],
    [
      184755.988131,
      "2026-03-11T00:00:00.000Z",
      15859
    ],
    [
      257838.63554244,
      "2026-03-10T00:00:00.000Z",
      18318
    ],
    [
      297688.72028205,
      "2026-03-09T00:00:00.000Z",
      19142
    ],
    [
      221088.47425891,
      "2026-03-08T00:00:00.000Z",
      15698
    ],
    [
      481192.03062575,
      "2026-02-06T00:00:00.000Z",
      24416
    ],
    [
      1016394.06686007,
      "2025-09-14T00:00:00.000Z",
      15532
    ],
    [
      0,
      "2024-10-27T00:00:00.000Z",
      8
    ]
  ]
}