Leaderboard rank check
leaderboard_rank_checkHow much company a return has. Send a return (+340%) and a window (day, week, month or all time) and get how many accounts on Hyperliquid's whole public leaderboard did the same or better, out of how many traded, its percentile, and the median account next to it. Every row of the exchange's own table, refreshed daily; the denominator is the accounts that traded, not the ones that sat idle.
Use when a trader or an ad quotes a return ("+340% this month") and you want to know how rare it is. Hyperliquid accounts only. Whether last month's top accounts stay on top is copy_trading_check; whether luck explains a win rate, overfitting_odds.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| window | Yes | day, week, month (default) or allTime. | month |
| return_pct | Yes | In percent: 340 means +340%. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | No | false when we do not hold that data. Never a zero standing in for an answer. | |
| error | No | no_data when ok is false. | |
| model | No | The method, stated. | |
| one_in | No | One account in how many. | |
| reason | No | Why, in one sentence, and what we do have instead. | |
| source | No | The public file these numbers come from. | |
| percentile | No | Share of accounts below it. | |
| same_or_better | No | Accounts at that return or above. | |
| median_return_pct | No | The middle account, same window. | |
| share_in_profit_pct | No | Accounts in profit, same window. | |
| accounts_that_traded | No | The denominator. |