nansen-profiler
Wallet profiler — balance, PnL, labels, transactions, counterparties, related wallets, batch, trace, compare. Use when analysing a specific wallet address or comparing wallets.
- Installs
- 133
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/nansen-ai/nansen-cli --skill nansen-profiler- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads nansen-profiler automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
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.
FAQ
What does the nansen-profiler skill do?
Wallet profiler — balance, PnL, labels, transactions, counterparties, related wallets, batch, trace, compare. Use when analysing a specific wallet address or comparing wallets.
How do I install nansen-profiler?
Run npx skills add https://github.com/nansen-ai/nansen-cli --skill nansen-profiler in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/nansen-profiler/ (personal) or .claude/skills/nansen-profiler/ (project).
Which AI agents can use nansen-profiler?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is nansen-profiler safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains nansen-profiler?
It is published by nansen-ai in nansen-ai/nansen-cli. It has 133 recorded installs.
More from nansen-ai/nansen-cli
nansen-web-searcher
nansen-ai/nansen-cli
Search the web for one or more queries in parallel. Use when you need current information, news, prices, or any web content to complement on-chain Nansen data.
nansen-smart-money-tracker
nansen-ai/nansen-cli
Smart money tracking — netflow, trades, holdings, perp trades. Use when finding what smart money wallets are buying/selling or tracking whale activity.
nansen-prediction-markets
nansen-ai/nansen-cli
Polymarket screeners — discover trending events, top markets by volume, and search for specific markets. Use when browsing what's happening on prediction markets.
nansen-smart-money-alpha
nansen-ai/nansen-cli
What tokens is smart money accumulating before they pump? Token screener with SM filter cross-referenced against netflow.
nansen-web-fetcher
nansen-ai/nansen-cli
Fetch and analyze content from one or more URLs using AI (Gemini 2.5 Flash). Use when you have specific URLs and need to extract or summarize their content. Pairs well with nansen web search results.
nansen-portfolio-tracker
nansen-ai/nansen-cli
How has a wallet's portfolio changed over time? Historical balances, current snapshot, and per-token PnL.
Popular other skills
hyperframes-cli
heygen-com/hyperframes
The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.
triage
mattpocock/skills
Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.
ask-matt
mattpocock/skills
Ask which skill or flow fits your situation. A router over the skills in this repo.
to-questionnaire
mattpocock/skills
Turn a decision you can't fully answer into a questionnaire for someone else to fill in.
loop-me
mattpocock/skills
Grill me about specs for the workflows I want to build, within this workspace.