skills/nansen-token-research/SKILL.md
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.
npx skillsauth add askeluv/nansen-cli nansen-token-researchInstall 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 token <sub> [options]
--chain required for spot endpoints. Use --token <address> for token-specific endpoints.
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
nansen research token holders --token <addr> --chain solana
nansen research token holders --token <addr> --chain solana --smart-money
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.
nansen research token dex-trades --token <addr> --chain solana --limit 20
nansen research token pnl --token <addr> --chain solana --sort total_pnl_usd:desc
nansen research token perp-trades --symbol ETH --days 7
nansen research token perp-positions --symbol BTC
nansen research token perp-pnl-leaderboard --symbol SOL
| 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 |
--symbol (e.g. BTC), not --token.holders --smart-money returns UNSUPPORTED_FILTER for tokens without SM tracking.flow-intelligence may return all-zero flows for illiquid tokens.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.