mcpField
N
nansen-portfolio-tracker

nansen-portfolio-tracker

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

关于 nansen-portfolio-tracker

nansen-portfolio-tracker 是通过 Nansen CLI 研究钱包资产变化的技能，适合分析指定地址的历史组合。它可查询历史余额并与当前余额对照，也能查看交易表现。

主要功能

  1. 01查询钱包历史余额
  2. 02查看当前链上余额
  3. 03对照历史与当前持仓
  4. 04查看交易盈亏表现

适用场景

  1. 01分析钱包过去一个月的资产变化
  2. 02识别历史期间新增或移除的代币
  3. 03检查钱包交易表现

MCP 相关

README 提及现有 OAuth/MCP `nansen:read` 权限语义保持不变；此技能通过 Nansen CLI 执行研究命令。

安装

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

$npx skills add https://github.com/nansen-ai/nansen-cli --skill nansen-portfolio-tracker

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

详细介绍

身份验证

浏览器登录会请求 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 historical-balances --address $ADDR --chain $CHAIN --days 30 --limit 20
# → block_timestamp, token_symbol, token_amount, value_usd, chain

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

nansen research profiler pnl --address $ADDR --chain $CHAIN --days 30 --limit 20
# → token_symbol, pnl_usd_realised, roi_percent_realised, bought_usd, sold_usd, holding_usd, nof_buys, nof_sells

将历史余额随时间的变化与当前余额进行比较，以查看新增／移除的资产。PnL 展示交易表现。

评论

支持 Markdown