search

🥇Leaderboards

The Leaderboards endpoints provide access to various rankings and performance metrics for traders, wallets, and vaults across the platform. These endpoints allow you to track performance by profit, equity, vault returns, and social metrics like favorites or verification. Both global and personalized user leaderboards are available.

circle-check

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.

hashtag
Get PERP PnL Leaderboard

/api/external/leaderboards/perp-pnl

Returns a perpetual PnL leaderboard for wallets ranked by performance over a selectable time horizon. Each row contains the wallet address and a full performance snapshot including current perp equity, open notional exposure, long exposure, exposure ratio and directional bias, absolute PnL and PnL percentage for day, week, month, and all-time, plus trading volume for the same periods. Results can be sorted and ranked by PnL over day, week, month, or all-time, and paginated using offset and limit.

chevron-rightQuery Parametershashtag
Parameter
Type
Description

offset

number

Number of rows to skip before returning results (pagination).

limit

number

Number of results to return. Allowed values: 25, 50, 100.

order

string

Sort direction. Allowed values: asc, desc. Default: desc.

orderBy

string

Field used to sort results by PnL period. Allowed values: pnlDay, pnlWeek, pnlMonth, pnlAllTime.

rankBy

string

Field used to compute the leaderboard rank by PnL period. Allowed values: pnlDay, pnlWeek, pnlMonth, pnlAllTime.

Request Examples

Response

200 Success: Returns the total number of eligible wallets and a page of leaderboard rows.

chevron-rightResponse Examplehashtag

circle-check

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.

hashtag
Get PERP PnL Leaderboard (Download Link)

/api/external/leaderboards/perp-pnl/{period}/download

Returns a temporary, pre-signed download link for exporting the perpetual PnL leaderboard for a selected period. The returned URL can be opened directly in a browser or fetched programmatically to download the export file. The link expires automatically after a short time.

Also found on the Downloadable Files subpage here.

chevron-rightQuery Parametershashtag
Parameter
Type
Description

period

string

Leaderboard period to export. Allowed values: day, week, month, all.

Request Examples

Response

200 Success: Returns a temporary download URL.

chevron-rightResponse Examplehashtag

hashtag
Get All HYPE Token Holders

/api/external/hype/holders

Returns a complete list of all HYPE token holders. For each holder you can see their wallet address, whether they have claimed their tokens, how many tokens they own, and what percentage of the total supply that amount represents.

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

Also found on the $HYPE Token Data subpage here.

chevron-rightQuery Parametershashtag
Parameter
Type
Description

offset

number

Number of results to skip before starting the list.

limit

number

Maximum number of holder records to return.

order

string

Sort direction. Allowed values: asc, desc.

orderBy

string

Field to order by. Allowed values: balance, percentage, address, updatedAt.

Request Examples

Response

200 Success: Returns all HYPE token holder data.

chevron-rightResponse Examplehashtag
PreviousLiquidation DataNextBuilder Analytics

Last updated