Back to Details

nansen-hyperliquid

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Nansen Hyperliquid — Perpetual Trading Analytics

Nansen Hyperliquid — 永续交易分析

Track smart money perpetual trading on Hyperliquid.
追踪Hyperliquid上的聪明钱永续交易。

When This Skill Activates

本Skill触发场景

  • "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
  • “聪明钱在Hyperliquid上交易什么？”
  • “永续交易 / 头寸 / 盈亏排行榜”
  • “谁在做多/做空BTC/ETH/SOL？”
  • 任何提及Hyperliquid + 交易/永续合约的场景

Command Routing

命令路由

User IntentCommandKey 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
用户意图命令关键选项
聪明钱永续交易
smart-money perp-trades
--limit
, 
--sort
, 
--filters
（无--chain）
按钱包查询永续交易
profiler perp-trades
--address
（必填）, 
--days
, 
--limit
按钱包查询未平仓头寸
profiler perp-positions
--address
（必填）, 
--limit
按代币查询永续交易
token perp-trades
--symbol
（必填）, 
--days
, 
--limit
按代币查询未平仓头寸
token perp-positions
--symbol
（必填）, 
--limit
盈亏排行榜
token perp-pnl-leaderboard
--symbol
（必填）, 
--days
, 
--limit

Common Symbols

常见代币符号

BTC, ETH, SOL, DOGE, ARB, OP, AVAX, MATIC, LINK, UNI, AAVE, WIF, PEPE, JUP, TIA
BTC, ETH, SOL, DOGE, ARB, OP, AVAX, MATIC, LINK, UNI, AAVE, WIF, PEPE, JUP, TIA

Examples

示例

bash
undefined
bash
undefined

Smart money trades right now

当前聪明钱交易情况

nansen smart-money perp-trades --sort value_usd:desc --limit 20 --table
nansen smart-money perp-trades --sort value_usd:desc --limit 20 --table

BTC PnL leaderboard

BTC盈亏排行榜

nansen token perp-pnl-leaderboard --symbol BTC --sort pnl_usd_total:desc --limit 20 --table
nansen token perp-pnl-leaderboard --symbol BTC --sort pnl_usd_total:desc --limit 20 --table

Open positions for SOL

SOL未平仓头寸

nansen token perp-positions --symbol SOL --sort position_value_usd:desc --table
nansen token perp-positions --symbol SOL --sort position_value_usd:desc --table

Trader's positions

交易者头寸

nansen profiler perp-positions --address 0x... --table
undefined
nansen profiler perp-positions --address 0x... --table
undefined

API-Only Endpoints (Not in CLI)

仅API可用的端点（暂未支持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
以下Hyperliquid端点已在Nansen API中存在，但暂未提供CLI命令：
  • 永续合约筛选器 (
    /api/v1/perp-screener
    ) — 按交易量、持仓量、资金费率、聪明钱活跃度筛选永续合约
  • 永续合约排行榜 (
    /api/v1/perp-leaderboard
    ) — 按指定日期范围内的盈亏/回报率排名Hyperliquid全球交易者

Direct API Examples

API直接调用示例

bash
undefined
bash
undefined

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"
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

返回字段: 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"
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

返回字段: token_symbol, volume, buy_volume, sell_volume, buy_sell_pressure, trader_count, mark_price, funding, open_interest

undefined
undefined

Investigation Flow

调研流程

  1. smart-money perp-trades
    → what are best traders doing?
  2. token perp-pnl-leaderboard
    → who's most profitable?
  3. profiler perp-positions
    → drill into a trader
  4. token perp-positions
    → market positioning on an asset
  1. smart-money perp-trades
    → 顶级交易者在做什么？
  2. token perp-pnl-leaderboard
    → 谁的盈利最多？
  3. profiler perp-positions
    → 深入分析单个交易者
  4. token perp-positions
    → 某一资产的市场持仓情况

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
  • 命令参数：
    references/commands.md
    （smart-money、profiler、token章节中的永续合约命令）
  • 示例响应：
    references/examples/smart-money-perp-trades.json
  • 聪明钱标签：
    references/smart-money-labels.md
  • 缓存 schema：
    references/schema.json

Attribution

版权说明

📊 Data by Nansen
📊 数据来源：Nansen