nansen-portfolio-history

Retrieve historical balances, portfolio snapshots, and PnL data for wallet addresses via Nansen API.

127|21|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/nansen-ai/nansen-cli --skill nansen-portfolio-history
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nansen-portfolio-history
Source: https://github.com/nansen-ai/nansen-cli/tree/main/skills/nansen-portfolio-history
Command: npx skills add https://github.com/nansen-ai/nansen-cli --skill nansen-portfolio-history

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps users understand how a cryptocurrency wallet's holdings and value have changed over a specified period, providing insights into investment performance and asset allocation shifts.

Core Features & Use Cases

  • Historical Balances: View past token amounts and their USD values at specific points in time.
  • Current Snapshot: Get the latest balance and valuation of all tokens in the wallet.
  • Profit & Loss (PnL): Analyze realized PnL, ROI, and trading activity (buys/sells) for assets held over a period.
  • Use Case: A user wants to see if their investment strategy in a specific wallet has been profitable over the last 30 days, and what assets contributed most to gains or losses.

Quick Start

Show me the historical balance of the wallet address 0x123... for the last 30 days on the Ethereum chain.

Frequently Asked Questions about nansen-portfolio-history

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I track crypto wallet portfolio evolution and historical balances?

To track crypto wallet portfolio evolution, retrieve historical balance, current snapshot, and profit/loss data for a given wallet address on specified blockchains using API access.

Can I analyze realized PnL and ROI for a specific wallet address?

Yes, you can analyze realized PnL, ROI, and trading activity like buys and sells for assets held over customizable timeframes to understand investment performance.

Do I need a Nansen API key to retrieve wallet balance history?

Yes, retrieving historical token amounts, USD valuations, and PnL data requires Nansen API access to query the specified blockchains.

What is the best way to view past token amounts and USD values for a wallet?

The best way to view past token amounts and USD values is to request a historical balance snapshot at specific points in time over a customizable timeframe.

Does this method support portfolio analysis across multiple blockchains?

Yes, portfolio analysis supports specified blockchains, allowing you to retrieve current balance snapshots and trading activity for tokens across the selected chains.