Compare Hyperliquid traders within a chosen ranking window. Returns public trader ranks, win rates, funding-inclusive PnL, fees, funding, volume and recorded activity context. Use one Toolmu account and a shared prepaid balance across available Tools. Pay per use; no separate supplier subscription is required. The current execution ceiling for this Tool is 0.0288 Toolmu credits per call. This is a maximum, not the settled charge. Before execution, get the current Tool contract and check availability, the latest maximumCredits, your balance and budget. Supplier response credits_used, when present, describes supplier API credits and is not the Toolmu customer charge.
Up to 0.0288 credits / call
The final charge is based on confirmed usage. Unused reserved credits return to your available balance.
Compare Hyperliquid traders within a chosen ranking window. Returns public trader ranks, win rates, funding-inclusive PnL, fees, funding, volume and recorded activity context. Use one Toolmu account and a shared prepaid balance across available Tools. Pay per use; no separate supplier subscription is required. The current execution ceiling for this Tool is 0.0288 Toolmu credits per call. This is a maximum, not the settled charge. Before execution, get the current Tool contract and check availability, the latest maximumCredits, your balance and budget. Supplier response credits_used, when present, describes supplier API credits and is not the Toolmu customer charge.
You receive
Returns public trader ranks, win rates, funding-inclusive PnL, fees, funding, volume and recorded activity context. total_pnl here includes fees and funding, unlike funding-excluded closed-trade net PnL. traded_pairs is lifetime context rather than strictly the ranking window.
Start with your task
Show me the top [number of traders] on Hyperliquid by [profit and loss, win rate, or trading volume] over [time period]. If I do not name a market, use Hyperliquid’s main market; if I do not choose a period or ranking method, use all available history and rank by profit and loss.
Inputs & outputs
Inspect the current inputs, availability, and maximum charge before starting.
Input schema
Input schema
Field / Path
Type
Requirement
Meaning
queryParamsqueryParams
object
Optional
dexqueryParams.dex
string
Optional
Market to rank within: main_dex (or omit) for the native market ONLY, or a builder market — one of: xyz, flx, vntl, hyna, km, abcd, cash, para, mkts. NOTE: the omit default differs from /trades/aggregate, where omitting dex aggregates across ALL markets.
Options
main_dex, xyz, flx, vntl, hyna, km, abcd, cash, para, mkts
limitqueryParams.limit
integer
Optional
Results per page (1-100). Defaults to 20.
Default
20
Minimum
1
Maximum
100
offsetqueryParams.offset
integer
Optional
Results to skip. Defaults to 0.
Default
0
Minimum
0
Maximum
9007199254740991
sort_byqueryParams.sort_by
string
Optional
Rank by this metric. Always sorted descending. Defaults to "total_pnl".
Default
total_pnl
Options
total_pnl, win_rate, volume_traded
min_tradesqueryParams.min_trades
integer
Optional
Only traders with at least this many trades. Defaults to 5; pass 0 for the full population. Defaults to 5.
Default
5
Minimum
0
Maximum
9007199254740991
time_rangequeryParams.time_range
string
Optional
Window to rank over. Default all (data starts 2025-08-01). Defaults to "all".
Default
all
Options
1d, 7d, 30d, 90d, all
min_days_activequeryParams.min_days_active
integer
Optional
Only traders active at least this many days (0 = no filter). Defaults to 0.
Default
0
Minimum
0
Maximum
9007199254740991
min_human_scorequeryParams.min_human_score
integer
Optional
Only traders scoring at least this, 0-100 (0 = no filter). Defaults to 0.
Compare Hyperliquid traders within a chosen ranking window
How to use this Tool
Use the deployed input fields below. Required fields must be supplied; optional filters narrow the result.
queryParams.dex (Optional): Market to rank within: main_dex (or omit) for the native market ONLY, or a builder market — one of: xyz, flx, vntl, hyna, km, abcd, cash, para, mkts. NOTE: the omit default differs from /trades/aggregate, where omitting dex aggregates across ALL markets.
queryParams.limit (Optional): Results per page (1-100). Defaults to 20.
queryParams.offset (Optional): Results to skip. Defaults to 0.
queryParams.sort_by (Optional): Rank by this metric. Always sorted descending. Defaults to "total_pnl".
queryParams.min_trades (Optional): Only traders with at least this many trades. Defaults to 5; pass 0 for the full population. Defaults to 5.
queryParams.time_range (Optional): Window to rank over. Default all (data starts 2025-08-01). Defaults to "all".
queryParams.min_days_active (Optional): Only traders active at least this many days (0 = no filter). Defaults to 0.
queryParams.min_human_score (Optional): Only traders scoring at least this, 0-100 (0 = no filter). Defaults to 0.
queryParams.min_account_age_days (Optional): Only accounts at least this old, in days (0 = no filter). Defaults to 0.
What this Tool returns
Returns public trader ranks, win rates, funding-inclusive PnL, fees, funding, volume and recorded activity context.
Response fields and how to read them
The table follows the official response contract, including nested fields and useful response metadata. [] denotes an array item. Required means required within its parent object, not that a conditional parent always exists. A nullable type permits null; an optional field can be absent. Use the documented conditions below to distinguish missing, empty and zero values. Units and reporting windows apply only where explicitly documented.
Paths in the table start at the Surf response root. In this Tool's saved Example, Toolmu stores that response inside result; for example, data.[].field corresponds to result.data.[].field in the saved run output. This wrapper and the observed rows describe the saved request, not a guarantee for every future input.
Field, type and presence
Meaning and conditions
data.[].account_age_days
integer; Optional within parent; format: int64
Account age in days (lifetime). Omitted when the trader has no fills on record.
data.[].address
string; Required within parent
Trader's wallet address (0x)
data.[].days_active
integer; Required within parent; format: int64
Distinct active days within the selected window
data.[].human_score
integer; Required within parent; format: int64
Human-likeness, 0-100
data.[].rank
integer; Required within parent; format: int64
1-based position within this response's window/sort/filter set, offset-adjusted (rank = offset + row index + 1). NOT a stable global id — it shifts as the leaderboard moves.
data.[].total_fees
number; Required within parent; format: double
Net fees, USD (positive = paid, negative = rebate)
data.[].total_funding
number; Required within parent; format: double
Net funding, USD (positive = received)
data.[].total_pnl
number; Required within parent; format: double
Net PnL over the window, USD (after fees + funding)
data.[].total_trades
integer; Required within parent; format: int64
Trades in the window
data.[].traded_pairs
array | null; Required within parent
Markets the trader has ever filled (lifetime — NOT limited to the selected window, unlike the metrics above), e.g. BTC, kPEPE, xyz:SILVER
data.[].volume_traded
number; Required within parent; format: double
Notional volume, USD
data.[].win_rate
number; Required within parent; format: double
Share of profitable trades (0-1)
meta.cached
boolean; Required within parent
Whether this response was served from cache
meta.credits_used
integer; Required within parent; format: int64
Credits deducted for this request
meta.empty_reason
string; Optional within parent
Hint explaining why the data array is empty, when applicable
meta.has_more
boolean; Optional within parent
Whether more items may exist beyond this response. For offset-paged endpoints, continue with a larger offset. For time-series endpoints without offset/cursor controls, true means the requested time range hit an upstream cap; narrow from/to to continue. Omitted when exhaustion cannot be proven.
meta.limit
integer; Required within parent; format: int64
Maximum number of items returned in this response
meta.offset
integer; Required within parent; format: int64
Number of items skipped (pagination offset)
meta.total
integer; Optional within parent; format: int64
Total number of matching items (before pagination). Omitted when total is unknown.
meta.watermark
integer; Optional within parent; format: int64
Warehouse watermark (Unix seconds) this response was computed at, on warehouse-backed endpoints (e.g. Hyperliquid /trades/aggregate) — rows up to this time come from the warehouse, newer rows from the live tail. Omitted elsewhere.
Coverage, units and freshness
total_pnl here includes fees and funding, unlike funding-excluded closed-trade net PnL. traded_pairs is lifetime context rather than strictly the ranking window.
Inspect any returned observation time, cache status, watermark, pagination and errors using their documented meanings. A successful request alone does not establish complete coverage. Where no freshness or completeness guarantee is documented, treat it as unknown. Saved Examples are historical and viewing them does not refresh data or execute a new call.
Data source and references
Surf supplies this endpoint through its Data API. Response contract and deployed Tool inputs reviewed on 2026-10-03 against official OpenAPI v0.2.102. This is a contract review date, not a data observation time. Coverage depends on the selected endpoint and request.
Use one Toolmu account and a shared prepaid balance across available Tools. Pay per use; no separate supplier subscription is required. The current execution ceiling for this Tool is 0.0288 Toolmu credits per call. This is a maximum, not the settled charge. Before execution, get the current Tool contract and check availability, the latest maximumCredits, your balance and budget. Supplier response credits_used, when present, describes supplier API credits and is not the Toolmu customer charge.
Rank by profit and loss
Show the top [5] Hyperliquid traders by [profit and loss] over [the past 7 days].
Rank traders on [Hyperliquid’s main market] by [win rate] over [the past 30 days], including only traders with at least [20 trades].
Show me the top [number of traders] on Hyperliquid by [profit and loss, win rate, or trading volume] over [time period]. If I do not name a market, use Hyperliquid’s main market; if I do not choose a period or ranking method, use all available history and rank by profit and loss.
Compare trading volume
Show Hyperliquid traders with the highest [trading volume] over [all available history].
Questions about this tool.
Inputs, results and details to know before running it.
queryParams.dex (Optional): Market to rank within: main_dex (or omit) for the native market ONLY, or a builder market — one of: xyz, flx, vntl, hyna, km, abcd, cash, para, mkts. NOTE: the omit default differs from /trades/aggregate, where omitting dex aggregates across ALL markets. queryParams.limit (Optional): Results per page (1-100). Defaults to 20. queryParams.offset (Optional): Results to skip. Defaults to 0. queryParams.sort_by (Optional): Rank by this metric. Always sorted descending. Defaults to "total_pnl". queryParams.min_trades (Optional): Only traders with at least this many trades. Defaults to 5; pass 0 for the full population. Defaults to 5. queryParams.time_range (Optional): Window to rank over. Default all (data starts 2025-08-01). Defaults to "all". queryParams.min_days_active (Optional): Only traders active at least this many days (0 = no filter). Defaults to 0. queryParams.min_human_score (Optional): Only traders scoring at least this, 0-100 (0 = no filter). Defaults to 0. queryParams.min_account_age_days (Optional): Only accounts at least this old, in days (0 = no filter). Defaults to 0.
Returns public trader ranks, win rates, funding-inclusive PnL, fees, funding, volume and recorded activity context.
total_pnl here includes fees and funding, unlike funding-excluded closed-trade net PnL. traded_pairs is lifetime context rather than strictly the ranking window.
Use one Toolmu account and a shared prepaid balance across available Tools. Pay per use; no separate supplier subscription is required. The current execution ceiling for this Tool is 0.0288 Toolmu credits per call. This is a maximum, not the settled charge. Before execution, get the current Tool contract and check availability, the latest maximumCredits, your balance and budget. Supplier response credits_used, when present, describes supplier API credits and is not the Toolmu customer charge.
Ask your agent to Compare Hyperliquid traders within a chosen ranking window. Provide the required inputs above. If Toolmu is already connected, reuse that connection; otherwise use the setup instructions on this page. Before a paid execution, the agent must read the current Tool contract and check availability, the credit ceiling, balance, budget and your authorization. It should then execute the Tool and explain the returned fields and limitations.
Inspect any returned observation time, cache status, watermark, pagination and errors using their documented meanings. A successful request alone does not establish complete coverage. Where no freshness or completeness guarantee is documented, treat it as unknown. Saved Examples are historical and viewing them does not refresh data or execute a new call.
