Nansen token research

Skill bg-szy/TOP-SKILLS/skills/marketplace/nansen-token-research

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.From its SKILL.md

Install

npx -y skills add bg-szy/TOP-SKILLS --skill nansen-token-research

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
4 stars4 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

2.5 KB, 607 tokens by cl100k_base, as published. Nobody here has run it

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.

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.