get_top_traders
Retrieve the top Hyperliquid traders ranked by PnL, ROI, or volume over a chosen time window, with filters to exclude market makers and low-volume accounts.
Instructions
Return the top N Hyperliquid traders by PnL / ROI / volume over a time window (24h, 7d, 30d, or all-time). Uses Hyperliquid's own public leaderboard endpoint — no API key, covers all 30k+ accounts. Returns addresses you can feed into get_positions / get_pnl_summary / get_fills for deeper analysis.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| window | No | Time window: 24h (day), 7d (week), 30d (month), or all (all-time). | 24h |
| limit | No | Number of top traders to return (1–50, default 10). | |
| sort_by | No | Ranking metric: pnl (total USD profit), roi (return on equity %), or volume (traded USD). | pnl |
| min_account_value | No | Optional filter: minimum account value in USD (default 0, i.e. no filter). Use e.g. 100000 to exclude dust accounts. | |
| min_volume_usd | No | Optional filter: minimum traded volume in USD within the selected window (default 0, i.e. no minimum beyond the exclude_zero_volume default). | |
| exclude_zero_volume | No | When true (default), skip accounts with zero traded volume in the selected window. These are typically vaults, settlement accounts, market-making pools, or inactive wallets holding unrealized PnL — not active traders. Set to false only when you explicitly want to see them. | |
| exclude_market_makers | No | When true (default), exclude market makers / HFT accounts. Detected via three heuristics: (1) turnover ratio (volume ÷ account value) above a per-window threshold — real directional traders rarely turn over >25× their equity in a week, MMs turn over 50–500×; (2) PnL efficiency (PnL ÷ volume) below 0.1% — MMs earn on spreads not direction; (3) display-name blacklist (auros, wintermute, jump, flow, gsr, amber, cumberland, b2c2, galaxy, dwf, hlp, vault, mm, etc.). Set to false to include MMs. | |
| max_turnover_ratio | No | Advanced override for the turnover filter used by exclude_market_makers. If set, accounts where volume ÷ account_value exceeds this ratio are dropped. Defaults: 10 for 24h, 25 for 7d, 100 for 30d, no cap for all-time. |