mcpField
N
nansen-perp-screener

nansen-perp-screener

github.com/nansen-ai数据与数据库144385 次安装今天更新
代码仓库

关于 nansen-perp-screener

nansen-perp-screener 是一项通过 Nansen CLI 查看 Hyperliquid 永续合约市场及交易者数据的研究技能，适用于追踪市场状态和交易者表现。它支持按交易者类型、标签和行业筛选，并查询排行榜与智能资金交易。

主要功能

  1. 01查看合约成交量与未平仓量
  2. 02按交易者类型和标签筛选
  3. 03按行业筛选代币
  4. 04查询交易者排行榜与智能资金交易

适用场景

  1. 01比较永续合约的成交量与买卖压力
  2. 02筛选特定类型或标签的交易者
  3. 03查看指定时间范围的交易者表现

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/nansen-ai/nansen-cli --skill nansen-perp-screener

安装后在 Claude Code 中输入/nansen-perp-screener确认已加载。

详细介绍

身份验证

浏览器登录会请求 nansen:api，以获取相当于 API 密钥的账户 API 权限；现有 OAuth/MCP nansen:read 语义和单独的钱包授权保持不变。

在执行任何研究命令或循环之前，必须明确选择 API 密钥或已保存的浏览器会话。先运行 nansen auth status。其缓存/未经验证的元数据无法证明凭据有效或存储已解锁。缓存的访问令牌仅过期，并不意味着会话不可用：CLI 通常会在已获授权的研究任务期间自动续期所选会话，无需再次征求同意或单独检查账户。如果选择匿名访问、身份验证状态无效、续期/清理受阻或情况不确定，或发生实际身份验证失败（包括刷新授权被拒绝或已过期），请停止。遵循 CLI 错误提示；如故障排查需要，可使用免费的 nansen account 检查。不要取消设置失效的密钥、清除会话，或切换到匿名访问后重试。

如需在文档规定的平台范围内重新进行浏览器授权，请使用 nansen login，或配置常规 API 密钥。NANSEN_API_KEY 的优先级高于已保存的会话。OpenClaw 的可选 primaryEnv 映射会保留已配置的 API 密钥注入；它不是必需密钥门槛，也不能证明已完成身份验证。正常的额度和权益照常适用。登录不会购买额度。CLI 2.0.0 中的浏览器登录仅适用于macOS arm64 预览版范围。

API 密钥和浏览器会话使用相同的 x402 自动支付行为：在现有钱包授权、支付策略和支出限额下，受支持的 HTTP 402 挑战可以从已配置的钱包中扣款。每次调用都可能产生费用，包括循环中的调用。身份验证、授权和会话续期失败绝不会触发支付；登录验证和 nansen account 检查也绝不会自动扣款。匿名 x402 仍可作为单独的付费工作流使用，但需要用户明确表示意图并完成支付设置。不要匿名运行此研究工作流，也不要在身份验证失败后切换到匿名访问。

永续合约市场扫描

回答：“当前 Hyperliquid 永续合约市场的状况如何？”

nansen research perp screener --sort volume:desc --limit 20
# → token_symbol, volume, buy/sell_volume, buy_sell_pressure, open_interest, funding, mark_price

nansen research perp leaderboard --days 7 --limit 20
# → trader_address, trader_address_label, total_pnl, roi, account_value

nansen research smart-money perp-trades --limit 20
# → token_symbol, side, action (Open/Close), value_usd, price_usd, trader_address_label

新增筛选条件（ECINT-6680）

--trader-type

按交易者类型筛选。可接受的值：all（默认）、sm、whale、public_figure、high_winrate_hl_perps_trader。

# Show only whale traders
nansen research perp screener --trader-type whale --limit 10

# Show only smart money traders
nansen research perp screener --trader-type sm --limit 20

# Show high win-rate HL perps traders
nansen research perp screener --trader-type high_winrate_hl_perps_trader --limit 20
--sm-label-filter

按逗号分隔的 Nansen SM 标签筛选。仅当 --trader-type 为 all 或 sm 时适用。

# Filter to a specific SM label
nansen research perp screener --trader-type sm --sm-label-filter "30D Smart Trader"

# Multiple labels
nansen research perp screener --sm-label-filter "30D Smart Trader,Smart LP"
--trader-label-filter

按逗号分隔的 HL 永续合约交易者标签筛选。仅当 --trader-type 为 all 或 sm 时适用。

# Filter to HL Perps Whale label
nansen research perp screener --trader-label-filter "HL Perps Whale"
--sectors-filter

按板块筛选币种，使用逗号分隔的 category:subcategory 对。

# Filter to AI and DeFi crypto sectors
nansen research perp screener --sectors-filter "Crypto:AI,Crypto:DeFi" --trader-type whale

# Combine with trader type and limit
nansen research perp screener --sectors-filter "Crypto:AI,Crypto:DeFi" --trader-type whale --limit 10 --sort volume:desc

组合示例

# Whale traders in AI crypto, sorted by volume
nansen research perp screener --trader-type whale --sectors-filter "Crypto:AI" --sort volume:desc --limit 10

# Smart money with specific label, last 7 days
nansen research perp screener --trader-type sm --sm-label-filter "30D Smart Trader" --days 7 --limit 20

# All traders in TradFi stocks sector
nansen research perp screener --sectors-filter "TradFi:Stocks" --sort open_interest:desc --limit 20

评论

支持 Markdown