Token Analytics
All commands: nansen research token <sub> [options]
--chain required. Use --token <address> for token-specific endpoints.
Screener
# Top tokens by volume
nansen research token screener --chain solana --timeframe 24h --limit 20
# Smart money only
nansen research token screener --chain solana --timeframe 24h --smart-money --limit 20
# Search within screener results (client-side filter)
nansen research token screener --chain solana --search "bonk"
Timeframes: 5m, 10m, 1h, 6h, 24h, 7d, 30d
Token Info & Indicators
nansen research token info --token <addr> --chain solana
nansen research token indicators --token <addr> --chain ethereum
indicators returns Nansen Score: risk indicators (BTC-reflexivity, token-supply-inflation) and reward indicators (funding-rate, price-momentum) with signal percentiles.
OHLCV
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, PnL & Transfers
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 transfers --token <addr> --chain solana --enrich
--enrich on transfers adds Nansen labels to from/to addresses.
Perps & DCA (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
nansen research token jup-dca --token <addr>
Flags
| Flag | Purpose |
|---|---|
--chain |
Required (ethereum, solana, base, etc.) |
--token |
Token address (alias: --token-address) |
--symbol |
Token symbol for perp endpoints (e.g. BTC) |
--timeframe |
Screener or OHLCV interval |
--smart-money |
Filter to SM wallets only (screener, holders) |
--days |
Lookback period (default 30) |
--sort |
Sort field:direction (e.g. total_pnl_usd:desc) |
--enrich |
Add Nansen labels to transfer addresses |
--fields |
Select specific fields |
--table |
Human-readable table output |
--format csv |
CSV export |
Notes
- Perp endpoints use
--symbol(e.g. BTC), not--token. jup-dcais Solana-only.holders --smart-moneyreturns UNSUPPORTED_FILTER for tokens without SM tracking.flow-intelligencemay return all-zero flows for illiquid tokens.