Nansen Portfolio Tracker
- 398 installs
- 127 repo stars
- Updated August 4, 2026
- nansen-ai/nansen-cli
nansen-portfolio-tracker is an agent skill that queries the Nansen CLI to report wallet historical balances, current holdings, and per-token PnL for developers who monitor on-chain treasury or trading exposure.
About
nansen-portfolio-tracker is an OpenClaw agent skill that wraps three Nansen CLI profiler commands—historical-balances, balance, and pnl—to answer how a wallet portfolio changed over a configurable window. Install the nansen-cli Node package, set NANSEN_API_KEY, and pass address and chain flags such as ethereum with --days 30. The skill compares historical token amounts and USD values against the current balance snapshot and surfaces realised PnL, ROI, buy/sell counts, and holding value per token. Reach for nansen-portfolio-tracker when auditing treasury wallets, reviewing trader performance, or checking concentration risk after large on-chain moves rather than building dashboards from scratch.
- Wallet portfolio views
- Holdings monitoring
- Exposure tracking
- Nansen CLI
Nansen Portfolio Tracker by the numbers
- 398 all-time installs (skills.sh)
- +6 installs in the week ending Aug 4, 2026 (Skillselion tracking)
- Ranked #260 of 1,106 Finance & Trading skills by installs in the Skillselion catalog
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/nansen-ai/nansen-cli --skill nansen-portfolio-trackerAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 398 |
|---|---|
| repo stars | ★ 127 |
| Last updated | August 4, 2026 |
| Repository | nansen-ai/nansen-cli ↗ |
How do you track on-chain wallet portfolio changes over time?
Track wallet and portfolio exposure via Nansen CLI to monitor holdings, PnL drivers, and concentration risk during ongoing trading or treasury management.
Who is it for?
Developers managing Ethereum treasury wallets or trading desks who already use Nansen and need repeatable CLI portfolio audits.
Skip if: Developers who need multi-chain portfolio dashboards without a Nansen API key or who only want static address labels without balance history.
When should I use this skill?
A developer asks how a wallet portfolio evolved, what tokens moved, or which positions drove PnL over the last N days.
What you get
Historical balance time series, current token holdings with USD values, and per-token realised PnL with buy/sell activity counts.
- historical balance time series
- current holdings snapshot
- per-token PnL report
By the numbers
- Wraps 3 nansen research profiler CLI subcommands
- Default example queries 30 days of history with --limit 20
Files
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_sellsCompare historical-balances over time against current balance to see what was added/removed. PnL shows trade performance.
Related skills
Wind Mcp SkillGive their AI coding agent instant access to comprehensive Chinese and global equity, fund, bond, and macroeconomic data from Wind.77.6k74
Upgrade StripeSafely upgrade their Stripe API version and SDKs without introducing breaking changes.55.6k1.7k
Recipe Create Expense TrackerInstantly create a ready-to-use Google Sheets expense tracker with headers, sample data, and sharing permissions.24.4k30.2k
Backtesting FrameworksCreate realistic event-driven backtesters that simulate order execution, slippage, commissions, and position tracking before committing capital to a trading strategy.13.5k38.5k
Grimoire PolymarketQuery live Polymarket odds, search events, and manage conditional order flow directly from Claude or Cursor without leaving the IDE.11.9k6
CoinglassGive their AI coding agents real-time access to crypto derivatives market data such as funding rates, open interest, long/short ratios, liquidations, and futures OHLC h11.4k21How it compares
Choose nansen-portfolio-tracker over generic block explorers when you need Nansen-labelled token PnL and historical USD valuations in one CLI workflow.
FAQ
What does nansen-portfolio-tracker require to run?
nansen-portfolio-tracker requires the nansen-cli Node package, the nansen binary on PATH, and a NANSEN_API_KEY environment variable. The skill authorizes Bash(nansen:*) commands and uses OpenClaw metadata to install nansen-cli automatically when configured.
Which Nansen CLI commands does the skill use?
nansen-portfolio-tracker calls nansen research profiler historical-balances for time-series holdings, balance for the current snapshot, and pnl for realised gains, ROI, and buy/sell counts. Compare historical output against balance to see adds and removals.