mcpField
N
nansen-token-research

nansen-token-research

github.com/nansen-ai其他144436 次安装今天更新
代码仓库

关于 nansen-token-research

这是一项使用 Nansen CLI 研究加密代币的技能，适合跟踪现货与永续市场价格、持有人、资金流和表现的分析人员。它覆盖代币级查询，并说明经过身份验证的使用方式。

主要功能

  1. 01代币信息与 OHLCV 数据
  2. 02持有人与聪明资金分析
  3. 03代币资金流与交易查询
  4. 04现货及永续合约盈亏数据
  5. 05CSV 与表格输出

适用场景

  1. 01比较代币价格区间
  2. 02查看聪明资金持仓与流向
  3. 03检查 DEX 交易和代币盈亏

MCP 相关

README 提到现有 OAuth/MCP `nansen:read` 权限保持不变；该技能本身介绍的是 Nansen CLI 研究命令。

安装

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

$npx skills add https://github.com/nansen-ai/nansen-cli --skill nansen-token-research

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

详细介绍

身份验证

浏览器登录会请求 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 仍可作为单独的付费工作流使用，但需要用户明确同意并完成付款设置。请勿匿名运行此研究工作流，也不要在身份验证失败后切换到匿名访问。

代币深入分析

所有命令：nansen research token <sub> [options]

现货端点需要 --chain。代币专属端点使用 --token <address>。

信息与价格

nansen research token info --token <addr> --chain solana
nansen research token ohlcv --token <addr> --chain solana --timeframe 1h

时间范围：1m、5m、15m、30m、1h、2h、4h、1d、1w、1M

持有者

nansen research token holders --token <addr> --chain solana
nansen research token holders --token <addr> --chain solana --smart-money

资金流

nansen research token flows --token <addr> --chain solana --days 7
nansen research token flow-intelligence --token <addr> --chain solana
nansen research token who-bought-sold --token <addr> --chain solana

flow-intelligence 按标签细分：巨鲸、聪明交易者、交易所、新钱包、公众人物。

DEX 交易

nansen research token dex-trades --token <addr> --chain solana --limit 20

盈亏

nansen research token pnl --token <addr> --chain solana --sort total_pnl_usd:desc

永续合约（无需 --chain）

nansen research token perp-trades --symbol ETH --days 7
nansen research token perp-positions --symbol BTC
nansen research token perp-pnl-leaderboard --symbol SOL

标志

标志用途
--chain现货端点必需（ethereum、solana、base 等）
--token代币地址（别名：--token-address）
--symbol永续合约端点的代币符号（例如 BTC）
--timeframeOHLCV 时间间隔
--smart-money仅筛选 SM 钱包（持有者）
--days回溯周期（默认 30）
--sort排序字段：方向（例如 total_pnl_usd:desc）
--fields选择特定字段
--table输出易读的表格
--format csv导出 CSV

注意事项

  • 永续合约端点使用 --symbol（例如 BTC），而非 --token。
  • 对于没有 SM 跟踪数据的代币，holders --smart-money 会返回 UNSUPPORTED_FILTER。
  • 对流动性较差的代币，flow-intelligence 可能返回全零资金流。

评论

支持 Markdown