mcpField
N
nansen-portfolio-history

nansen-portfolio-history

github.com/nansen-aiData & databases14479 installsUpdated today
Repository

About nansen-portfolio-history

A skill for reviewing a wallet’s historical and current portfolio balances with Nansen. It supports comparing token holdings over time to see what changed and includes PnL as a measure of trade performance.

Key features

  1. 01Query historical balances
  2. 02View current token balances
  3. 03Compare holdings over time
  4. 04Review trade PnL

Use cases

  1. 01Track portfolio changes over the past month
  2. 02Identify tokens added or removed from a wallet

Install

Copy the command and run it in a terminal.

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

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

Details

From the project README

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