How do I install the Nansen Token Research skill?

Run npx skillmds@latest add gabrielmoreira/nansen-token-research in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Nansen Token Research safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Nansen Token Research?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Nansen Token Research free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Nansen Token Research?

gabrielmoreira (@gabrielmoreira) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Nansen Token Research by gabrielmoreira

Name: Nansen Token Research
Rating: 4.2 (5 reviews)
Author: gabrielmoreira

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.

gabrielmoreira Updated Sep 9, 2026 17 repo stars

File contents

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.

---name: nansen-token-researchdescription: 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.--- # 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 | 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.

Frequently asked questions