Get Hyperliquid perpetual futures trader leaderboard with performance metrics.
Returns:
Trader performance rankings as markdown.
Columns returned:
- **Address** / **Label**: trader wallet, and its Nansen label if any
- **Total PnL** (USD): realized + unrealized over the date range
- **Realized PnL** (USD): net, from positions closed in the range. Being a net total it shows no per-trade outcome, so no win rate can be derived from it or any other column here
- **Unrealized PnL** (USD): on positions still open, at the current mark price
- **ROI** (%): Total PnL / (traded notional + open notional) — PnL per dollar traded, not return on capital
- **Volume** (USD): traded notional; both fills of a position count
- **Trades**: number of fills
- **Account Value** (USD): only available for the top 500K traders
This is an overview of top traders and their headline stats. For a trader's
open positions, call `address_portfolio` with `mode='hyperliquid'`.
**Sorting**: total_pnl, realized_pnl_usd, unrealized_pnl_usd, roi, volume_usd, total_trades, account_value
**Filtering** (from/to): totalPnl (USD), accountValue (USD), roi (a fractional ratio, not the percent shown — pass 0.1 for "10% or better", not 10)
Example:
```
{
"date": {"from": "7D_AGO", "to": "NOW"},
"accountValue": {"from": 100000, "to": 1000000},
"totalPnl": {"from": 10000},
"order_by": "total_pnl",
"orderByDirection": "DESC"
}
```
Rank by traded volume instead: `"order_by": "volume_usd"`
Notes:
- Hyperliquid perpetual futures only
- Null/empty means data is not available — do not read it as zero
Connector
