Hyperliquid Wallet PnL Distribution

Get real-time statistics of Hyperliquid wallets grouped into tiers by PnL size, 8 tiers from Money_Printer to Giga_Rekt, including address counts, long and short position values and shares, long/short sentiment, and the distribution of profitable and losing addresses.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Available on these API plans: Standard Professional Enterprise

Update frequencyReal-time

Response Data

data is an array; each element is one PnL tier. group_name is the tier tag in lowercase: money_printer | smart_money | grinder | humble_earner | exit_liquidity | semi_rekt | full_rekt | giga_rekt. minimum_amount and maximum_amount are the tier's PnL amount range (in USD); for example, smart_money is 100000–1000000, and money_printer has a lower bound of 1000000 and no upper bound. Loss tiers run the other way: minimum_amount is the end with the smaller loss and maximum_amount the end with the larger loss, e.g., -100000 to -1000000 for full_rekt, while giga_rekt has only minimum_amount (-1000000), meaning a loss of $1 million or more. This endpoint has no request parameters.

📘

Share Fields Are Already Percentage Values

The *_percent fields are in %: 72.46 means 72.46%; there is no need to multiply by 100.

200 · application/json · See the response example in the right panel.

FieldTypeAlways ReturnedDescription
codestringYesBusiness status code; "0" means success
msgstringNoResult message; may be omitted on success
dataarray of objectYesStatistics by PnL amount tier; each element is one tier
data[].group_namestringYesTier tag, lowercase; for the possible values, see the description above
data[].all_address_countintegerYesTotal number of addresses tracked in the tier
data[].position_address_countintegerYesNumber of these addresses that currently hold positions
data[].position_address_percentnumberYesAddresses with positions as a share of the tier's total addresses, in %
data[].bias_scorenumberYesLong/short bias score; positive values correspond to a bullish bias_remark, negative values to a bearish one; the larger the absolute value, the more pronounced the bias
data[].bias_remarkstringYesLong/short sentiment label; values seen so far: very_bearish, bearish, slightly_bearish, indecisive, slightly_bullish, bullish, very_bullish
data[].minimum_amountnumberYesStart of the tier's PnL range, in USD. For profit tiers it is the smaller end, and for loss tiers it is the end with the smaller loss, e.g., -100000 for full_rekt
data[].maximum_amountnumberNoEnd of the tier's PnL range, in USD. For profit tiers it is the larger end, and for loss tiers it is the end with the larger loss, e.g., -1000000 for full_rekt; not returned for the two outermost tiers, money_printer and giga_rekt
data[].long_position_usdnumberYesLong position value of the tier, in USD
data[].short_position_usdnumberYesShort position value of the tier, in USD
data[].long_position_usd_percentnumberYesShare of long position value, in %
data[].short_position_usd_percentnumberYesShare of short position value, in %
data[].position_usdnumberYesTotal position value of the tier (long + short), in USD
data[].profit_address_countintegerYesNumber of profitable addresses
data[].loss_address_countintegerYesNumber of losing addresses
data[].profit_address_percentnumberYesShare of profitable addresses, in %
data[].loss_address_percentnumberYesShare of losing addresses, in %

API Plans

Only the API plans marked Yes in the table below can call this endpoint. For the price of each plan, see API Plans.

API PlanAccess
Hobbyist❌ No
Startup❌ No
Standard✅ Yes
Professional✅ Yes
Enterprise✅ Yes

Use This Endpoint with AI

Pick a task and click Open in ChatGPT or Open in Claude: the AI reads this page first and then gives you the result. You can also click Copy and paste the full prompt into the AI tool you use.

Track the direction of winning wallets
Have AI write a script that periodically records the long/short bias of the two most profitable wallet tiers.
Compare winning and losing wallets
Have AI write code that compares the long and short positions of the profitable and losing tiers.
Understand this endpoint
Have AI explain how the tiers are formed and each field in plain language.

This endpoint provides data through the REST API. Use the prompts above to have AI write the request code. For the tools available through MCP, see CoinGlass MCP.

Use Cases

ScenarioDescription
Follow Smart MoneyWatch the long/short direction of consistently profitable wallets such as Money_Printer and Smart_Money.
Contrarian ReferenceWatch the direction of the wallets that have lost the most, such as Full_Rekt and Giga_Rekt, as a contrarian sentiment reference.
Sentiment DashboardTurn the bias_remark and long/short shares of the 8 tiers into a dashboard to see at a glance which side the winners and the losers are betting on.
Combine with Historical DataIf you need the historical changes of a tier, use Hyperliquid Position Distribution (by Tag).

Related Endpoints

EndpointHow It Differs
Hyperliquid Wallet Position DistributionTiers by position size, with the same fields
Hyperliquid Position Distribution (by Tag)Historical data for one tier
Hyperliquid Long/Short Account Ratio (by Tag)History of long and short account counts for one tier on a given coin
Hyperliquid Whale PositionsPosition-by-position details of large positions

FAQ

Does a percentage field value of 55.32 mean 55.32%?

Yes. All *_percent fields of this endpoint are already percentage values: 55.32 means 55.32%; there is no need to multiply by 100.

Why do some tiers have no maximum_amount?

The two outermost tiers do not return this field: the most profitable tier, money_printer (minimum_amount of 1000000, i.e., a profit of $1 million or more), and the tier with the largest losses, giga_rekt (minimum_amount of -1000000, i.e., a loss of $1 million or more). Check whether the field exists before reading it; for loss tiers, do not apply “minimum ≤ PnL ≤ maximum” but read the bounds by absolute value.

How is it different from Hyperliquid Wallet Position Distribution?

The returned fields are exactly the same; the difference is what the tiers are based on: this endpoint groups by PnL amount, while Hyperliquid Wallet Position Distribution groups by position size.

Is group_name uppercase or lowercase?

It is actually returned in lowercase, e.g., money_printer, giga_rekt. When calling the endpoint that queries history by tag, the docs for the wallet_tag parameter write the values with initial capitals, e.g., Money_Printer.

Learn More: Hyperliquid Wallet PnL Tiers

What Do Money_Printer, Smart_Money and Giga_Rekt Mean?

These are names given to wallets by PnL amount. The profitable tiers, from highest to lowest, are Money_Printer, Smart_Money, Grinder and Humble_Earner; the losing tiers are Exit_Liquidity, Semi_Rekt, Full_Rekt and Giga_Rekt. Rekt is crypto slang for “lost badly”.

Why Look at the Direction of Profitable Wallets?

Consistently profitable wallets tend to have more trading experience, and their collective direction can serve as a reference for market sentiment, but past profits do not mean they are necessarily right this time.

Can PnL Tiers and Position Tiers Be Viewed Together?

Yes. Looking at this endpoint together with Hyperliquid Wallet Position Distribution lets you tell whether the two groups, those with “large positions” and those who “earn the most”, agree.

Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json