mcpField
N
nansen-token

nansen-token

github.com/nansen-aiData & databases144136 installsUpdated today
Repository

About nansen-token

A skill for exploring token research data through the Nansen CLI. It covers spot prices, holders, flows, DEX trades, PnL, and perpetual-market data, with chain- or symbol-based queries.

Key features

  1. 01Token info and OHLCV
  2. 02Holder and smart-money data
  3. 03Flows and flow intelligence
  4. 04DEX trades and PnL
  5. 05Perpetual trades, positions, and leaderboards
  6. 06Table and CSV output

Use cases

  1. 01Review a token's price history
  2. 02Inspect holder and flow activity
  3. 03Compare token PnL data
  4. 04Explore perpetual-market activity

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/nansen-ai/nansen-cli --skill nansen-token

After installing, type/nansen-tokenin Claude Code to confirm it loaded.

Details

From the project README

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

FlagPurpose
--chainRequired for spot endpoints (ethereum, solana, base, etc.)
--tokenToken address (alias: --token-address)
--symbolToken symbol for perp endpoints (e.g. BTC)
--timeframeOHLCV interval
--smart-moneyFilter to SM wallets only (holders)
--daysLookback period (default 30)
--sortSort field:direction (e.g. total_pnl_usd:desc)
--fieldsSelect specific fields
--tableHuman-readable table output
--format csvCSV 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.

Comments

Markdown supported