nansen-token
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.
How do I install this agent skill?
npx skills add https://github.com/nansen-ai/nansen-cli --skill nansen-tokenIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill is safe to use. It provides tools for cryptocurrency token research through the official Nansen analytics platform. It requires a Nansen API key, which is handled securely via environment variables, and it uses the official Nansen command-line interface.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
1 file scanned · No issues
What does this agent skill do?
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-moneyreturns UNSUPPORTED_FILTER for tokens without SM tracking.flow-intelligencemay return all-zero flows for illiquid tokens.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/nansen-ai/nansen-cli/nansen-token">View nansen-token on skillZs</a>