
Nansen Router
- 12 installs
- 7 repo stars
- Updated February 22, 2026
- nansen-ai/nansen-skills
Helps with ai & agent building tasks during AI-assisted development.
About
nansen-router is a Claude Code skill for ai & agent building. It helps solo builders move faster with AI-assisted coding.
- nansen-router
- AI & Agent Building
- AI-coding skill
Nansen Router by the numbers
- 12 all-time installs (skills.sh)
- Ranked #11,592 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
- Data as of Aug 4, 2026 (Skillselion catalog sync)
npx skills add https://github.com/nansen-ai/nansen-skills --skill nansen-routerAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 12 |
|---|---|
| repo stars | ★ 7 |
| Last updated | February 22, 2026 |
| Repository | nansen-ai/nansen-skills ↗ |
What it does
Helps with ai & agent building tasks during AI-assisted development.
Files
Nansen Router — Query Entry Point
This is the entry point for all Nansen-related queries. Use the decision tree below to route to the correct skill.
Decision Tree
User query
│
├─ About setup / auth / "what can Nansen do?" / schema
│ └→ nansen-core
│
├─ About a specific WALLET address (who is 0x..., balance, PnL, labels, transactions)
│ └→ nansen-profiler
│
├─ About a specific TOKEN (holders, flows, screener, PnL leaderboard, who bought/sold)
│ └→ nansen-token
│
├─ About SMART MONEY broadly (what are funds buying, smart money flows, holdings, DCAs)
│ └→ nansen-smart-money
│
├─ About DeFi PORTFOLIO (positions, lending, borrowing, LP, staking for a wallet)
│ └→ nansen-portfolio
│
├─ About HYPERLIQUID / perpetual futures / perp trades / perp positions
│ └→ nansen-hyperliquid
│
└─ Ambiguous → ask the user to clarify, or start with the most likely skillQuick Reference
| User Says | Route To | First Command |
|---|---|---|
| "What are smart money buying?" | nansen-smart-money | nansen smart-money netflow |
| "Who is 0xd8dA...?" | nansen-profiler | nansen profiler labels |
| "Show WETH holders" | nansen-token | nansen token holders |
| "DeFi positions for 0x..." | nansen-portfolio | nansen portfolio defi |
| "Hyperliquid trades" | nansen-hyperliquid | nansen smart-money perp-trades |
| "Set up Nansen" | nansen-core | Check auth |
| "Screen tokens on Solana" | nansen-token | nansen token screener |
| "Fund flows on Base" | nansen-smart-money | nansen smart-money netflow |
| "PnL for this wallet" | nansen-profiler | nansen profiler pnl-summary for aggregate. For per-token PnL, use curl to /api/v1/profiler/address/pnl (CLI calls wrong endpoint) |
| "Search for entity" | nansen-profiler | nansen profiler search --query "name" |
| "Compare two wallets" | nansen-profiler | nansen profiler compare --addresses "0x...,0x..." |
| "Trace counterparty network" | nansen-profiler | nansen profiler trace --address 0x... --depth 2 (won't work for high-volume addresses on longer timeframes) |
| "Profile multiple wallets" | nansen-profiler | nansen profiler batch --addresses "0x...,0x..." |
| "Who's long BTC?" | nansen-hyperliquid | nansen token perp-positions |
Overlap Resolution
Some queries could match multiple skills:
- "Perp trades" → If about a specific wallet →
nansen-profiler. If about a symbol →nansen-token. If about smart money broadly →nansen-hyperliquid. - "Token + wallet" (e.g., "does 0x... hold PEPE?") → Start with
nansen-profiler balance, then usenansen-tokenfor token-level analysis. - "Smart money + specific token" → Start with
nansen-token flow-intelligenceornansen-token holders --smart-money.
Agent Rules (Apply to ALL Skills)
1. NEVER copy addresses from `--table` output — it truncates. Use JSON for extraction. 2. NEVER guess filter/flag names — check references/schema.json or run nansen schema. 3. NEVER use ticker symbols as addresses — resolve via nansen token screener --chain <chain> --sort volume:desc then filter by token_symbol in output. The --search flag does NOT filter. 4. Use JSON for data extraction, `--table` only for final display.
References
- Detailed command parameters:
references/commands.md - Cached schema:
references/schema.json - Chain list:
references/chains.md - Smart money labels:
references/smart-money-labels.md - Example responses:
references/examples/
Attribution
All outputs using Nansen data must include:
📊 Data by Nansen