skills/nansen-wallet-profiler/SKILL.md
Wallet profiler — balance, PnL, labels, transactions, counterparties, related wallets, batch, trace, compare. Use when analysing a specific wallet address or comparing wallets.
npx skillsauth add nansen-ai/nansen-cli nansen-wallet-profilerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
All commands: nansen research profiler <sub> [options]
--address and --chain required for most commands.
nansen research profiler balance --address <addr> --chain ethereum
nansen research profiler labels --address <addr> --chain ethereum
nansen research profiler search --query "Vitalik"
nansen research profiler pnl --address <addr> --chain ethereum --days 30
nansen research profiler pnl-summary --address <addr> --chain ethereum
nansen research profiler transactions --address <addr> --chain ethereum --limit 20
nansen research profiler historical-balances --address <addr> --chain solana --days 30
nansen research profiler related-wallets --address <addr> --chain ethereum
nansen research profiler counterparties --address <addr> --chain ethereum --days 30
nansen research profiler perp-positions --address <addr>
nansen research profiler perp-trades --address <addr> --days 7
# 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
| 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 |
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 --addresses.documentation
Guide users through native limit orders on Solana via `nansen trade limit-order create|list|cancel|update`, and the alert-based settlement-signal fallback for chains without native support. Use when a user wants a price-triggered buy or sell.
data-ai
Execute DEX swaps on Solana or Base, including cross-chain bridges. Use when buying or selling a token, getting a swap quote, or executing a trade.
tools
Pay-per-call access to the Nansen API via MPP (Tempo). Use when a user wants anonymous Nansen access without an API key and without managing their own Base/Solana wallet — they install the tempo CLI separately and call the API through `tempo request`.
tools
Discover trending tokens — screener, SM holdings, Nansen indicators, and flow intelligence for promising finds. Use when scanning for new tokens or screening what's hot.