nansen-token-research

Original：🇺🇸 English
Translated

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.

3installs
Sourcenansen-ai/nansen-cli
Added on

NPX Install

npx skill4agent add nansen-ai/nansen-cli nansen-token-research

Tags

Translated version includes tags in frontmatter
token-deep-divenansen-clicrypto-data-analysisdex-tradesperp-contracts

SKILL.md Content

View Translation Comparison →

Token Deep Dive

All commands: 
nansen research token <sub> [options]
--chain
required for spot endpoints. Use 
--token <address>
for token-specific endpoints.

Info & Price

bash
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

bash
nansen research token holders --token <addr> --chain solana
nansen research token holders --token <addr> --chain solana --smart-money

Flows

bash
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

bash
nansen research token dex-trades --token <addr> --chain solana --limit 20

PnL

bash
nansen research token pnl --token <addr> --chain solana --sort total_pnl_usd:desc

Perps (no --chain)

bash
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

FlagPurpose
--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.