Nansen Token Research
- 388 installs
- 127 repo stars
- Updated August 4, 2026
- nansen-ai/nansen-cli
nansen-token-research is an agent skill that runs deep token diligence through Nansen CLI subcommands covering holders, OHLCV, flows, DEX trades, and perpetual positions for on-chain investment or integration validation.
About
nansen-token-research is a skill from nansen-ai/nansen-cli that orchestrates Nansen CLI token research via `nansen research token <sub>` commands with required `--chain` flags and `--token <address>` for spot endpoints. Covered subcommands include info, OHLCV, holders, flows, flow intelligence, who bought/sold, DEX trades, PnL, perp trades, perp positions, and perp PnL leaderboard. The skill requires nansen-cli and NANSEN_API_KEY, allowing agents to Bash-invoke structured diligence without manual API wiring. Developers reach for nansen-token-research when validating a specific token's holder concentration, smart-money flow, or derivatives exposure before backend integration or portfolio decisions.
- Holder analytics
- Flow and label data
- Token due diligence
- Nansen CLI research
Nansen Token Research by the numbers
- 388 all-time installs (skills.sh)
- +4 installs in the week ending Aug 4, 2026 (Skillselion tracking)
- Ranked #32 of 479 Web3 & Blockchain skills by installs in the Skillselion catalog
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/nansen-ai/nansen-cli --skill nansen-token-researchAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 388 |
|---|---|
| repo stars | ★ 127 |
| Last updated | August 4, 2026 |
| Repository | nansen-ai/nansen-cli ↗ |
How do you research a crypto token on-chain?
Run deep token diligence with Nansen CLI—holders, flows, labels, and cohort behavior—to validate investment or integration theses on specific assets.
Who is it for?
Developers and analysts with Nansen API access who need CLI-driven deep dives on a specific token address across spot and perpetual metrics.
Skip if: Skip nansen-token-research for macro fund portfolio tracking across many tokens—use nansen-fund-tracker—or when no token address and chain are specified.
When should I use this skill?
User asks for a token deep dive, holder analysis, flow intelligence, DEX trades, or perp positions for a specific on-chain asset.
What you get
Token info report, OHLCV series, holder cohort breakdown, flow intelligence, DEX trade log, and perpetual position summaries.
- Token diligence report
- Holder and flow analysis
- OHLCV and trade summaries
By the numbers
- Supports 10+ token research subcommands including OHLCV, holders, flows, and perp positions
- Requires nansen-cli npm package and NANSEN_API_KEY env var
Files
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 1hTimeframes: 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-moneyFlows
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 solanaflow-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 20PnL
nansen research token pnl --token <addr> --chain solana --sort total_pnl_usd:descPerps (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 SOLFlags
| 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-moneyreturns UNSUPPORTED_FILTER for tokens without SM tracking.flow-intelligencemay return all-zero flows for illiquid tokens.
Related skills
Solidity SecurityCatch and fix critical Solidity vulnerabilities like reentrancy before deploying smart contracts.13k38.4k
Extension Http OutcallsEnable their Internet Computer backend canister to make secure HTTP GET and POST requests to external APIs.10.3k
Okx Dapp DiscoveryCorrectly route Chinese-language DeFi and on-chain queries to the right protocol plugins inside an agent workflow.9.5k315Okx Growth CompetitionGuide users through OKX OnchainOS competition reward status checks, atomic claims, and post-win contact collection via the onchainos CLI.9.1k315Okx Agent Payments ProtocolLet their AI agent create and fulfill on-chain payment links without leaving the coding session.8.7k315
Query Token InfoGive your coding agent a Node CLI to search Binance tokens and pull metadata while you build crypto or DeFi features.6.1k946How it compares
Use nansen-token-research for single-token deep dives; use nansen-fund-tracker for labeled fund portfolio snapshots across many holdings.
FAQ
Which Nansen CLI command does nansen-token-research use?
nansen-token-research invokes `nansen research token <sub>` subcommands with `--chain` required for spot endpoints and `--token <address>` for token-specific queries covering info, OHLCV, holders, flows, and perpetual metrics.
What token metrics can nansen-token-research retrieve?
nansen-token-research retrieves token info, OHLCV price data, holder cohorts, flow intelligence, who bought/sold signals, DEX trades, PnL, perp trades, perp positions, and perp PnL leaderboard entries via Nansen CLI.