🇺🇸English
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 |
Notes
pnl-summary has no pagination support (returns aggregate stats, not a list).perp-positions has no pagination support.labels has no pagination support — the API ignores per_page and always returns all labels for the address. --limit is not available for this sub-command.transactions caps at per_page=100 (API limit).trace makes many API calls — use --width conservatively.batch accepts --file <path> with one address per line as alternative to .
Weekly Installs
133
Repository
nansen-ai/nansen-cli
GitHub Stars
104
First Seen
Mar 1, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykPass
Installed on
codex129
opencode128
kimi-cli127
gemini-cli127
github-copilot127
cursor127
