nansen-token
Token deep dive — info, OHLCV, holders, flows, flow intelligence, who bought/sold, DEX trades, PnL, perp trades, perp positions, perp PnL leaderboard. Use when researching a specific token in depth.
- Installs
- 136
- 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-token- 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-token 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.
Token Deep Dive
All commands: nansen research token <sub> [options]
--chain required for spot endpoints. Use --token <address> for token-specific endpoints.
Info & Price
nansen research token info --token <addr> --chain solana
nansen research token ohlcv --token <addr> --chain solana --timeframe 1h
Timeframes: 1m, 5m, 15m, 30m, 1h, 2h, 4h, 1d, 1w, 1M
Holders
nansen research token holders --token <addr> --chain solana
nansen research token holders --token <addr> --chain solana --smart-money
Flows
nansen research token flows --token <addr> --chain solana --days 7
nansen research token flow-intelligence --token <addr> --chain solana
nansen research token who-bought-sold --token <addr> --chain solana
flow-intelligence breaks down by label: whales, smart traders, exchanges, fresh wallets, public figures.
DEX Trades
nansen research token dex-trades --token <addr> --chain solana --limit 20
PnL
nansen research token pnl --token <addr> --chain solana --sort total_pnl_usd:desc
Perps (no --chain)
nansen research token perp-trades --symbol ETH --days 7
nansen research token perp-positions --symbol BTC
nansen research token perp-pnl-leaderboard --symbol SOL
Flags
| Flag | Purpose |
|---|---|
--chain | Required for spot endpoints (ethereum, solana, base, etc.) |
--token | Token address (alias: --token-address) |
--symbol | Token symbol for perp endpoints (e.g. BTC) |
--timeframe | OHLCV interval |
--smart-money | Filter to SM wallets only (holders) |
--days | Lookback period (default 30) |
--sort | Sort field:direction (e.g. total_pnl_usd:desc) |
--fields | Select specific fields |
--table | Human-readable table output |
--format csv | CSV export |
Notes
- Perp endpoints use
--symbol(e.g. BTC), not--token. holders --smart-moneyreturns UNSUPPORTED_FILTER for tokens without SM tracking.flow-intelligencemay return all-zero flows for illiquid tokens.
FAQ
What does the nansen-token skill do?
Token deep dive — info, OHLCV, holders, flows, flow intelligence, who bought/sold, DEX trades, PnL, perp trades, perp positions, perp PnL leaderboard. Use when researching a specific token in depth.
How do I install nansen-token?
Run npx skills add https://github.com/nansen-ai/nansen-cli --skill nansen-token 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-token/ (personal) or .claude/skills/nansen-token/ (project).
Which AI agents can use nansen-token?
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-token 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-token?
It is published by nansen-ai in nansen-ai/nansen-cli. It has 136 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
Open the skill to read its SKILL.md instructions.
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.