nansen-hyperliquid

用途

Nansen Hyperliquid 用于追踪 Hyperliquid 上的聪明钱永续合约交易。当用户询问聪明钱在 Hyperliquid 上的交易、永续成交/持仓/盈亏排行榜，或谁在做多/做空 BTC、ETH、SOL 等，或任何同时提到 Hyperliquid 与交易/永续合约的场景时，该技能激活。

主要能力

该技能提供以下命令能力：

聪明钱永续成交：命令 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。

常用币种：BTC、ETH、SOL、DOGE、ARB、OP、AVAX、MATIC、LINK、UNI、AAVE、WIF、PEPE、JUP、TIA。

使用方式

命令示例：

# 当前聪明钱交易
nansen smart-money perp-trades --sort value_usd:desc --limit 20 --table

# BTC 盈亏排行榜
nansen token perp-pnl-leaderboard --symbol BTC --sort pnl_usd_total:desc --limit 20 --table

# SOL 未平仓头寸
nansen token perp-positions --symbol SOL --sort position_value_usd:desc --table

# 某交易者的持仓
nansen profiler perp-positions --address 0x... --table

仅 API 端点（CLI 中暂无命令）

以下 Hyperliquid 端点存在于 Nansen API，但尚未提供 CLI 命令：

Perp Screener（/api/v1/perp-screener）：按成交量、未平仓量、资金费率、聪明钱活动筛选永续合约。
Perp Leaderboard（/api/v1/perp-leaderboard）：按日期范围查看全球 Hyperliquid 交易者按盈亏/ROI 的排行榜。

直接调用 API 示例：

# 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"
# 返回：trader_address, trader_address_label, total_pnl, roi, account_value

# 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"
# 返回：token_symbol, volume, buy_volume, sell_volume, buy_sell_pressure, trader_count, mark_price, funding, open_interest

适用场景

典型调查流程：

smart-money perp-trades → 最好的交易者在做什么？
token perp-pnl-leaderboard → 谁最赚钱？
profiler perp-positions → 深入分析某个交易者。
token perp-positions → 某个资产的市场仓位分布。

参考资料

命令参数：references/commands.md（smart-money、profiler、token 部分中的永续命令）
响应示例：references/examples/smart-money-perp-trades.json
聪明钱标签：references/smart-money-labels.md
缓存 schema：references/schema.json

限制

Perp Screener 与 Perp Leaderboard 两个端点仅在 API 中提供，CLI 尚无对应命令。其他限制（如费率、配额等）暂未提供。

数据来源：Nansen。