nansen-token-research

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-money returns UNSUPPORTED_FILTER for tokens without SM tracking.
• flow-intelligence may return all-zero flows for illiquid tokens.