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

Security Scan

The skill's requirements and instructions are consistent with a CLI wrapper for Nansen token research; it asks only for the Nansen API key and the nansen CLI binary and contains no unrelated access requests.

Purpose & Capability

Name/description describe Nansen token research and the skill requires the 'nansen' CLI and NANSEN_API_KEY, which are exactly what a Nansen CLI integration would need. No unrelated services or credentials are requested.

Instruction Scope

SKILL.md consists solely of explicit nansen CLI commands (research token subcommands and flags). It does not instruct the agent to read arbitrary files, other environment variables, or send data to endpoints outside the Nansen CLI's normal behavior.

Install Mechanism

Install is a Node package (nansen-cli) that provides the 'nansen' binary. npm installs are an expected way to provide a CLI, but downloading and installing a package executes third-party code on the host — moderate risk. The skill metadata lists no source/homepage, so users should verify the npm package publisher and integrity before installing.

Credentials

Only NANSEN_API_KEY is required and it's declared as the primary credential. That matches the described functionality (requests to Nansen API). No additional secrets or config paths are requested.

Persistence & Privilege

Skill is not always-enabled and does not request elevated platform privileges. Autonomous invocation is allowed by default (normal for skills) but not combined with other concerning flags.

Assessment

This skill appears to be an instruction-only wrapper around the official Nansen CLI and only needs your NANSEN_API_KEY. Before installing, verify the npm package 'nansen-cli' publisher and reviews (or prefer installing the CLI yourself), and limit the API key permissions/monitor usage if possible (to avoid unexpected billing or data exposure). Installing a Node package will run third-party code on your system — proceed only if you trust the package source. If you need stricter control, run the nansen CLI manually outside the skill and paste results instead of granting an API key to the skill.

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.