nansen-wallet-profiler▌
nansen-ai/nansen-cli · updated Apr 8, 2026
All commands: nansen research profiler <sub> [options]
Wallet Profiler
All commands: nansen research profiler <sub> [options]
--address and --chain required for most commands.
Balance & Identity
nansen research profiler balance --address <addr> --chain ethereum
nansen research profiler labels --address <addr> --chain ethereum
nansen research profiler search --query "Vitalik"
PnL
nansen research profiler pnl --address <addr> --chain ethereum --days 30
nansen research profiler pnl-summary --address <addr> --chain ethereum
Transactions & History
nansen research profiler transactions --address <addr> --chain ethereum --limit 20
nansen research profiler historical-balances --address <addr> --chain solana --days 30
Relationships
nansen research profiler related-wallets --address <addr> --chain ethereum
nansen research profiler counterparties --address <addr> --chain ethereum --days 30
Perps (no --chain)
nansen research profiler perp-positions --address <addr>
nansen research profiler perp-trades --address <addr> --days 7
Batch, Trace & Compare
# Batch — profile multiple wallets at once
nansen research profiler batch \
--addresses "0xabc,0xdef" --chain ethereum \
--include labels,balance,pnl
# Trace — BFS multi-hop counterparty trace (makes N*width API calls)
nansen research profiler trace --address <addr> --chain ethereum --depth 2 --width 5
# Compare — shared counterparties and tokens between two wallets
nansen research profiler compare --addresses "0xabc,0xdef" --chain ethereum
Flags
| Flag | Purpose |
|---|---|
--address |
Wallet address (required) |
--chain |
Required except for perps and search |
--days |
Lookback period (default 30) |
--limit |
Number of results |
--include |
Batch fields: labels,balance,pnl |
--depth |
Trace depth 1-5 (default 2) |
--width |
Trace width — keep low to save credits |
--fields |
Select specific fields |
--table |
Human-readable table output |
--format csv |
CSV export |
Notes
pnl-summaryhas no pagination support (returns aggregate stats, not a list).perp-positionshas no pagination support.labelshas no pagination support — the API ignoresper_pageand always returns all labels for the address.--limitis not available for this sub-command.transactionscaps at per_page=100 (API limit).tracemakes many API calls — use--widthconservatively.batchaccepts--file <path>with one address per line as alternative to--addresses.
Ratings
4.5★★★★★10 reviews- ★★★★★Shikha Mishra· Oct 10, 2024
nansen-wallet-profiler is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.
- ★★★★★Piyush G· Sep 9, 2024
Keeps context tight: nansen-wallet-profiler is the kind of skill you can hand to a new teammate without a long onboarding doc.
- ★★★★★Chaitanya Patil· Aug 8, 2024
Registry listing for nansen-wallet-profiler matched our evaluation — installs cleanly and behaves as described in the markdown.
- ★★★★★Sakshi Patil· Jul 7, 2024
nansen-wallet-profiler reduced setup friction for our internal harness; good balance of opinion and flexibility.
- ★★★★★Ganesh Mohane· Jun 6, 2024
I recommend nansen-wallet-profiler for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
- ★★★★★Oshnikdeep· May 5, 2024
Useful defaults in nansen-wallet-profiler — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
- ★★★★★Dhruvi Jain· Apr 4, 2024
nansen-wallet-profiler has been reliable in day-to-day use. Documentation quality is above average for community skills.
- ★★★★★Rahul Santra· Mar 3, 2024
Solid pick for teams standardizing on skills: nansen-wallet-profiler is focused, and the summary matches what you get after install.
- ★★★★★Pratham Ware· Feb 2, 2024
We added nansen-wallet-profiler from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
- ★★★★★Yash Thakker· Jan 1, 2024
nansen-wallet-profiler fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.