mcpField
N
nansen-wallet-deep-dive

nansen-wallet-deep-dive

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

关于 nansen-wallet-deep-dive

nansen-wallet-deep-dive 是一项通过 Nansen CLI 研究钱包身份、持仓和活动的 skill，结合 profiler 查询与明确的认证及支付防护。

主要功能

  1. 01查询钱包标签与类别
  2. 02查询代币余额和价值
  3. 03查询永续合约仓位
  4. 04认证与支付防护

适用场景

  1. 01识别钱包标签和类别
  2. 02查看代币持仓及美元价值
  3. 03检查 Hyperliquid 未平仓仓位

MCP 相关

README 提到现有 OAuth/MCP `nansen:read` 语义保持不变；此 skill 通过 `nansen` CLI 指引研究操作。

安装

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

$npx skills add https://github.com/nansen-ai/nansen-cli --skill nansen-wallet-deep-dive

安装后在 Claude Code 中输入/nansen-wallet-deep-dive确认已加载。

详细介绍

身份验证

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

钱包分析

回答：“这个钱包是谁，它一直在做什么？”

ADDR=<address> CHAIN=ethereum

nansen research profiler labels --address $ADDR --chain $CHAIN
# → label, category (e.g. "Smart Trader", "Fund", "Public Figure", ENS names)

nansen research profiler balance --address $ADDR --chain $CHAIN
# → token_symbol, token_name, token_amount, price_usd, value_usd per holding

nansen research profiler pnl-summary --address $ADDR --chain $CHAIN --days 30
# → realized_pnl_usd, realized_pnl_percent, win_rate, traded_token_count, traded_times, top5_tokens

nansen research profiler transactions --address $ADDR --chain $CHAIN --limit 20
# → block_timestamp, method, tokens_sent, tokens_received, volume_usd, source_type

nansen research profiler perp-positions --address $ADDR
# → asset_positions, margin_summary_account_value_usd, margin_summary_total_margin_used_usd

nansen research profiler counterparties --address $ADDR --chain $CHAIN --days 30
# → counterparty_address, counterparty_address_label, interaction_count, total_volume_usd, volume_in/out_usd

perp-positions 返回 Hyperliquid 数据——如果钱包没有未平仓的永续合约，则返回空结果。

评论

支持 Markdown