mcpField
N
nansen-portfolio-tracker

nansen-portfolio-tracker

github.com/nansen-aiOther144444 installsUpdated 1d ago
Repository

About nansen-portfolio-tracker

nansen-portfolio-tracker is a Nansen CLI skill for researching changes in a wallet's assets over time. It retrieves historical balances for an address, supports comparison with current balances, and includes access to PnL information.

Key features

  1. 01Retrieve historical wallet balances
  2. 02View current on-chain balances
  3. 03Compare past and current holdings
  4. 04Review trading PnL

Use cases

  1. 01Analyze a wallet's asset changes over a month
  2. 02Identify tokens added or removed over time
  3. 03Review wallet trading performance

MCP support

The README notes that existing OAuth/MCP `nansen:read` semantics remain unchanged; this skill runs research commands through the Nansen CLI.

Install

Copy the command and run it in a terminal.

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

After installing, type/nansen-portfolio-trackerin Claude Code to confirm it loaded.

Details

From the project README

Authentication

Browser login requests nansen:api for API-key-equivalent account API permissions; existing OAuth/MCP nansen:read semantics and separate wallet authorization are unchanged.

Before any research command or loop, require an explicitly selected API key or saved browser session. Run nansen auth status first. Its cached/unverified metadata does not prove credential validity or unlocked storage. Cached access-token expiry alone does not mean the session is unusable: the CLI normally renews a selected session automatically during an already-authorized research task, without another consent request or a separate account check. Stop on anonymous selection, invalid authentication state, blocked or uncertain renewal/cleanup, or an actual authentication failure, including rejected or expired refresh authority. Follow the CLI error guidance; use the free nansen account check when troubleshooting calls for it. Do not unset a failed key, erase a session or switch to anonymous access to retry.

Use nansen login for fresh browser approval within the documented platform scope, or configure a conventional API key. NANSEN_API_KEY overrides the saved session. OpenClaw's optional primaryEnv mapping preserves configured API-key injection; it is not a required-key gate or proof of authentication. Normal credits and entitlements apply. Login does not purchase credits. Browser login is available in CLI 2.0.0 within the macOS arm64 preview scope.

API keys and browser sessions use the same automatic x402 payment behavior: a supported HTTP 402 challenge can spend funds from the configured wallet under existing wallet authorization, payment policy and spending limits. Each call, including calls in loops, can incur a payment. Authentication, authorization and session-renewal failures never trigger payment; login verification and nansen account never pay automatically. Anonymous x402 remains available as a separate paid workflow requiring explicit user intent and payment setup. Do not run this research workflow anonymously or switch to anonymous access after authentication fails.

Portfolio History

Answers: "How has this wallet's portfolio evolved over the past month?"

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

Compare historical-balances over time against current balance to see what was added/removed. PnL shows trade performance.

Comments

Markdown supported