About nansen-token
A skill for exploring token research data through the Nansen CLI. It covers spot prices, holders, flows, DEX trades, PnL, and perpetual-market data, with chain- or symbol-based queries.
Key features
- 01Token info and OHLCV
- 02Holder and smart-money data
- 03Flows and flow intelligence
- 04DEX trades and PnL
- 05Perpetual trades, positions, and leaderboards
- 06Table and CSV output
Use cases
- 01Review a token's price history
- 02Inspect holder and flow activity
- 03Compare token PnL data
- 04Explore perpetual-market activity
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ nansen-ai/ nansen-cli --skill nansen-tokenAfter installing, type/nansen-tokenin Claude Code to confirm it loaded.
Details
From the project READMEToken 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.
Comments
Markdown supported