Nansen Portfolio Tracker

How has a wallet's portfolio changed over time? Historical balances, current snapshot, and per-token PnL.

Security Scan

The skill's requests and runtime instructions are consistent with its stated purpose (calling the Nansen CLI with a Nansen API key to fetch wallet history/PnL).

Purpose & Capability

The skill is a Nansen portfolio tracker and only requires the 'nansen' CLI and NANSEN_API_KEY. These requirements reasonably match the described functionality (historical balances, snapshot, per-token PnL).

Instruction Scope

SKILL.md instructs only to run nansen CLI commands against a supplied wallet address and chain. This will transmit the wallet address/queries to Nansen's service (expected for this purpose). No unrelated files, system paths, or extraneous environment variables are referenced.

Install Mechanism

Install uses the npm package 'nansen-cli' to provide the 'nansen' binary. That is coherent for this skill but carries the normal npm risk surface (installing third-party code).

Credentials

Only NANSEN_API_KEY is required and declared as the primary credential. That is proportional to calling Nansen's API via their CLI.

Persistence & Privilege

The skill is not always-enabled and does not request elevated platform privileges or modify other skills. Autonomous invocation is allowed (platform default) but not exceptional here.

Assessment

This skill appears to do what it says: run the Nansen CLI against a wallet address using your Nansen API key. Before installing, verify you trust the nansen-cli npm package and its publisher (review the package repo and recent release history). Be aware that any wallet addresses you pass will be sent to Nansen's service, and your NANSEN_API_KEY will be used by the CLI — limit the key's scope if possible and rotate it if you suspect compromise. Never provide private keys or sensitive secrets; only provide the API key required by Nansen. If you have high security requirements, consider running the npm install in an isolated environment (container/VM) and inspect the package contents before use.

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.