Nansen Hyperliquid — Perpetual Trading Analytics
Track smart money perpetual trading on Hyperliquid.
When This Skill Activates
- "What are smart money trading on Hyperliquid?"
- "Perp trades / positions / PnL leaderboard"
- "Who's long/short on BTC/ETH/SOL?"
- Any mention of Hyperliquid + trading/perps
Command Routing
| User Intent |
Command |
Key Options |
| Smart money perp trades |
smart-money perp-trades |
--limit, --sort, --filters (no --chain) |
| Perp trades by wallet |
profiler perp-trades |
--address (req), --days, --limit |
| Perp positions by wallet |
profiler perp-positions |
--address (req), --limit |
| Perp trades by symbol |
token perp-trades |
--symbol (req), --days, --limit |
| Open positions by symbol |
token perp-positions |
--symbol (req), --limit |
| PnL leaderboard |
token perp-pnl-leaderboard |
--symbol (req), --days, --limit |
Common Symbols
BTC, ETH, SOL, DOGE, ARB, OP, AVAX, MATIC, LINK, UNI, AAVE, WIF, PEPE, JUP, TIA
Examples
# Smart money trades right now
nansen smart-money perp-trades --sort value_usd:desc --limit 20 --table
# BTC PnL leaderboard
nansen token perp-pnl-leaderboard --symbol BTC --sort pnl_usd_total:desc --limit 20 --table
# Open positions for SOL
nansen token perp-positions --symbol SOL --sort position_value_usd:desc --table
# Trader's positions
nansen profiler perp-positions --address 0x... --table
API-Only Endpoints (Not in CLI)
These Hyperliquid endpoints exist in the Nansen API but have no CLI command yet:
- Perp Screener (
/api/v1/perp-screener) — Screen perp contracts by volume, OI, funding, smart money activity
- Perp Leaderboard (
/api/v1/perp-leaderboard) — Global Hyperliquid trader leaderboard by PnL/ROI over a date range
Direct API Examples
# Perp Leaderboard — top traders by PnL over a date range
curl -s -X POST -H "apikey: $NANSEN_API_KEY" -H "Content-Type: application/json" \
-d '{"date":{"from":"2026-02-01","to":"2026-02-15"}}' \
"https://api.nansen.ai/api/v1/perp-leaderboard"
# Returns: trader_address, trader_address_label, total_pnl, roi, account_value
# Perp Screener — screen perp contracts by volume, OI, funding
curl -s -X POST -H "apikey: $NANSEN_API_KEY" -H "Content-Type: application/json" \
-d '{"date":{"from":"2026-02-01","to":"2026-02-15"}}' \
"https://api.nansen.ai/api/v1/perp-screener"
# Returns: token_symbol, volume, buy_volume, sell_volume, buy_sell_pressure, trader_count, mark_price, funding, open_interest
Investigation Flow
smart-money perp-trades → what are best traders doing?token perp-pnl-leaderboard → who's most profitable?profiler perp-positions → drill into a tradertoken perp-positions → market positioning on an asset
References
- Command parameters:
references/commands.md (perp commands in smart-money, profiler, token sections)
- Example response:
references/examples/smart-money-perp-trades.json
- Smart money labels:
references/smart-money-labels.md
- Cached schema:
references/schema.json
Attribution
📊 Data by Nansen
1---2name: nansen-hyperliquid3description: Hyperliquid perpetual trading analytics via Nansen CLI. Track smart money perp trades, open positions, PnL leaderboards, and trader analysis on Hyperliquid.4---56# Nansen Hyperliquid — Perpetual Trading Analytics78Track smart money perpetual trading on Hyperliquid.910## When This Skill Activates1112- "What are smart money trading on Hyperliquid?"13- "Perp trades / positions / PnL leaderboard"14- "Who's long/short on BTC/ETH/SOL?"15- Any mention of Hyperliquid + trading/perps1617## Command Routing1819| User Intent | Command | Key Options |20|------------|---------|-------------|21| Smart money perp trades | `smart-money perp-trades` | `--limit`, `--sort`, `--filters` *(no --chain)* |22| Perp trades by wallet | `profiler perp-trades` | `--address` (req), `--days`, `--limit` |23| Perp positions by wallet | `profiler perp-positions` | `--address` (req), `--limit` |24| Perp trades by symbol | `token perp-trades` | `--symbol` (req), `--days`, `--limit` |25| Open positions by symbol | `token perp-positions` | `--symbol` (req), `--limit` |26| PnL leaderboard | `token perp-pnl-leaderboard` | `--symbol` (req), `--days`, `--limit` |2728## Common Symbols2930BTC, ETH, SOL, DOGE, ARB, OP, AVAX, MATIC, LINK, UNI, AAVE, WIF, PEPE, JUP, TIA3132## Examples3334```bash35# Smart money trades right now36nansen smart-money perp-trades --sort value_usd:desc --limit 20 --table3738# BTC PnL leaderboard39nansen token perp-pnl-leaderboard --symbol BTC --sort pnl_usd_total:desc --limit 20 --table4041# Open positions for SOL42nansen token perp-positions --symbol SOL --sort position_value_usd:desc --table4344# Trader's positions45nansen profiler perp-positions --address 0x... --table46```4748## API-Only Endpoints (Not in CLI)4950These Hyperliquid endpoints exist in the Nansen API but have **no CLI command yet**:5152- **Perp Screener** (`/api/v1/perp-screener`) — Screen perp contracts by volume, OI, funding, smart money activity53- **Perp Leaderboard** (`/api/v1/perp-leaderboard`) — Global Hyperliquid trader leaderboard by PnL/ROI over a date range5455### Direct API Examples5657```bash58# Perp Leaderboard — top traders by PnL over a date range59curl -s -X POST -H "apikey: $NANSEN_API_KEY" -H "Content-Type: application/json" \60 -d '{"date":{"from":"2026-02-01","to":"2026-02-15"}}' \61 "https://api.nansen.ai/api/v1/perp-leaderboard"62# Returns: trader_address, trader_address_label, total_pnl, roi, account_value6364# Perp Screener — screen perp contracts by volume, OI, funding65curl -s -X POST -H "apikey: $NANSEN_API_KEY" -H "Content-Type: application/json" \66 -d '{"date":{"from":"2026-02-01","to":"2026-02-15"}}' \67 "https://api.nansen.ai/api/v1/perp-screener"68# Returns: token_symbol, volume, buy_volume, sell_volume, buy_sell_pressure, trader_count, mark_price, funding, open_interest69```7071## Investigation Flow72731. `smart-money perp-trades` → what are best traders doing?742. `token perp-pnl-leaderboard` → who's most profitable?753. `profiler perp-positions` → drill into a trader764. `token perp-positions` → market positioning on an asset7778## References7980- Command parameters: `references/commands.md` (perp commands in smart-money, profiler, token sections)81- Example response: `references/examples/smart-money-perp-trades.json`82- Smart money labels: `references/smart-money-labels.md`83- Cached schema: `references/schema.json`8485## Attribution8687> 📊 Data by [Nansen](https://nansen.ai)
nansen-ai