用途
nansen-holder-analysis 用于回答一个核心问题：某个代币是被优质钱包持有，还是由散户噪声主导？它通过 Nansen CLI 的研究命令，从持有者构成、资金流向和近期买卖行为三个角度给出判断依据。
主要能力
该技能包含三条研究命令：
- 持有者分析：
TOKEN=<address> CHAIN=ethereum
nansen research token holders --token $TOKEN --chain $CHAIN --smart-money --limit 20
输出字段包括 address、address_label、value_usd、ownership_percentage、balance_change_24h/7d/30d。
- 资金流向情报：
nansen research token flow-intelligence --token $TOKEN --chain $CHAIN
输出按标签划分的 net_flow_usd 与 wallet_count，标签包括 smart_trader、whale、exchange、fresh_wallets。
- 近期买卖明细：
nansen research token who-bought-sold --token $TOKEN --chain $CHAIN --limit 20
输出字段包括 address、address_label、bought/sold_volume_usd、bought/sold_token_volume、trade_volume_usd。
判断参考
资料给出的信号提示：危险信号为 fresh_wallets 资金流高且 SM 持有者少；积极信号为前 20 名持有者中出现 Fund/Smart Trader 标签。
使用方式与认证
在任何研究命令或循环之前，必须先明确选择 API 密钥或已保存的浏览器会话，并先运行 nansen auth status。其缓存或未验证的元数据不能证明凭据有效或存储已解锁。仅凭缓存访问令牌过期并不代表会话不可用：CLI 通常会在已授权的任务中自动续期所选会话，无需再次同意或单独账户检查。遇到匿名选择、无效认证状态、续期/清理被阻止或不确定、或实际认证失败（包括刷新权限被拒绝或过期）时应停止。遵循 CLI 错误指引；排障需要时可使用免费的 nansen account check。不要取消失败的密钥、清除会话或切换到匿名访问来重试。
可使用 nansen login 在文档所述平台范围内进行新的浏览器批准，或配置常规 API 密钥。NANSEN_API_KEY 会覆盖已保存的会话。OpenClaw 的可选 primaryEnv 映射保留已配置的 API 密钥注入，它不是必需密钥门禁，也不构成认证证明。正常积分与权益适用。登录不会购买积分。浏览器登录在 CLI 2.0.0 的 macOS arm64 预览范围内可用。
API 密钥与浏览器会话使用相同的自动 x402 支付行为：受支持的 HTTP 402 挑战可在既有钱包授权、支付策略和支出限额下从配置钱包支出资金。每次调用（包括循环中的调用）都可能产生支付。认证、授权和会话续期失败不会触发支付；登录验证和 nansen account 从不自动支付。匿名 x402 作为单独的付费工作流保留，需要明确的用户意图和支付设置。不要在认证失败后匿名运行此研究工作流或切换到匿名访问。
适用场景
适合在评估代币持有结构、判断资金质量、观察聪明钱与巨鲸动向、识别新钱包异常流入等场景中使用。
限制
持有者端点不支持原生或包装代币，必须使用具体的代币合约地址。