---

name: nansen-token description: Token analytics — screener, indicators, OHLCV, holders, flows, PnL, DEX trades, flow intelligence. Use when researching a specific token, checking smart money holders, or screening trending tokens. metadata: openclaw: requires: env: - NANSEN_API_KEY bins: - nansen primaryEnv: NANSEN_API_KEY install: - kind: node package: nansen-cli bins: [nansen] allowed-tools: Bash

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

Notes

• Perp endpoints use --symbol (e.g. BTC), not --token.
• jup-dca is Solana-only.
• holders --smart-money returns UNSUPPORTED_FILTER for tokens without SM tracking.
• flow-intelligence may return all-zero flows for illiquid tokens.