mcpField
N
nansen-wallet-batch

nansen-wallet-batch

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

关于 nansen-wallet-batch

通过 Nansen 命令行批量查询指定链上的钱包地址、标签和代币余额。它可筛选带有聪明钱或基金标签的地址，并逐个报告错误，不会因单个地址出错而中断批次。

主要功能

  1. 01批量分析钱包地址
  2. 02返回标签及可选余额
  3. 03逐个报告地址错误
  4. 04筛选聪明钱或基金标签

适用场景

  1. 01筛查地址列表中的聪明钱钱包
  2. 02查询所选钱包的代币余额

MCP 相关

该技能使用 Nansen 命令行；README 指出，现有 OAuth/MCP `nansen:read` 语义保持不变。

安装

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

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

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

详细介绍

身份验证

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

ADDRESSES="0xaddr1,0xaddr2,0xaddr3,..." CHAIN=ethereum
nansen research profiler batch --addresses "$ADDRESSES" --chain $CHAIN --include labels,balance
# → .data.{total, completed, results[]: {address, chain, labels[], balance, error}}
# labels[]: {label, category ("smart_money","fund","social","behavioral","others"), kind[]}
# balance: {data[]: {token_symbol, token_amount, price_usd, value_usd}}

检查每个结果的 .error：无效地址会返回错误消息，而不会导致崩溃。跳过这些地址。 保留任何 label.category == "smart_money" 或 "fund" 的地址。省略余额以加快检查。

评论

支持 Markdown