nansen-perps: nansen_perp_pnl_leaderboard
nansen_perp_pnl_leaderboardPnL leaderboard for ONE Hyperliquid coin: which traders made the most trading it (realized/unrealized PnL, ROI, current position, trade count). 5 credits.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"token_symbol": "<token_symbol>"
},
"name": "nansen_perp_pnl_leaderboard"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | Look-back window in days ending now (default 30). Ignored when date_from is set. | |
| page | No | Page number for pagination (default 1) | |
| limit | No | Rows to return (1-100, default 20) | |
| labels | No | Restrict to wallets with these Smart Money labels. 'Smart Trader' = historically profitable spot traders; 'Smart HL Perps Trader' = profitable Hyperliquid perp traders. | |
| date_to | No | Explicit end (YYYY-MM-DD or ISO 8601). Defaults to now. | |
| sort_by | No | Sort field (default pnl_usd_total) | |
| date_from | No | Explicit start (YYYY-MM-DD or ISO 8601). Overrides days. | |
| token_symbol | Yes | Hyperliquid coin symbol, e.g. 'BTC', 'ETH', 'SOL', 'HYPE' | |
| sort_direction | No | Sort direction (default DESC) |