nansen-wallet-profiler

身份验证

浏览器登录会请求 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 profiler <sub> [options]

大多数命令都需要 --address 和 --chain。

余额与身份

nansen research profiler balance --address <addr> --chain ethereum
nansen research profiler labels --address <addr> --chain ethereum
nansen research profiler search --query "Vitalik"

盈亏

nansen research profiler pnl --address <addr> --chain ethereum --days 30
nansen research profiler pnl-summary --address <addr> --chain ethereum

交易与历史记录

nansen research profiler transactions --address <addr> --chain ethereum --limit 20
nansen research profiler historical-balances --address <addr> --chain solana --days 30

关系

nansen research profiler related-wallets --address <addr> --chain ethereum
nansen research profiler counterparties --address <addr> --chain ethereum --days 30

# Counterparties for up to 10 wallets in one call (max --days 90).
# Results are not aggregated — every row carries the wallet_address it belongs to.
# One ecosystem per request: EVM and Solana addresses cannot be mixed; `all` auto-detects it.
# --chain also takes any single chain the profiler serves, EVM or not: arbitrum, arc,
# avalanche, base, bitcoin, bnb (`bsc` is accepted too), ethereum, hyperevm, injective,
# iotaevm, linea, mantle, mantra, monad, near, optimism, plasma, polygon, robinhood, sei,
# solana, sonic, starknet, sui, ton, tron.
# Rows come back as contiguous per-wallet blocks ordered by wallet address, so a small page
# holds one wallet only — raise --limit and page with --page N to reach later wallets.
nansen research profiler counterparties-batch --addresses "0xabc,0xdef" --days 30 --limit 50

永续合约（无需 --chain）

nansen research profiler perp-positions --address <addr>
nansen research profiler perp-trades --address <addr> --days 7

批量、追踪与比较

# Batch — profile multiple wallets at once
nansen research profiler batch \
  --addresses "0xabc,0xdef" --chain ethereum \
  --include labels,balance,pnl

# Trace — BFS multi-hop counterparty trace (makes N*width API calls)
nansen research profiler trace --address <addr> --chain ethereum --depth 2 --width 5

# Compare — shared counterparties and tokens between two wallets
nansen research profiler compare --addresses "0xabc,0xdef" --chain ethereum

标志

标志	用途
--address	钱包地址（必需）
--chain	永续合约和搜索命令除外，其他命令均必需
--days	回溯时长（默认 30）
--limit	结果数量
--addresses	供 batch、compare、counterparties-batch 使用的逗号分隔钱包列表
--include	批量字段：labels,balance,pnl
--depth	追踪深度 1-5（默认 2）
--width	追踪宽度——调低以节省额度
--fields	选择特定字段
--table	以易读表格形式输出
--format csv	导出 CSV

注意事项

• pnl-summary 不支持分页（返回汇总统计数据，而不是列表）。
• perp-positions 不支持分页。
• labels 支持分页——--limit/--page 会生效，响应格式为 {pagination: {page, per_page, is_last_page}, data[]: {label, category, kind[]}}。
• transactions 的每页结果上限为 100（API 限制）。
• trace 会发起大量 API 调用——谨慎使用 --width。
• batch 可通过 --file <path> 接收每行一个地址的文件，作为 --addresses 的替代方式。