mcpField
N
nansen-holder-quality

nansen-holder-quality

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

About nansen-holder-quality

A skill for evaluating the wallets holding a token using Nansen holder and flow data. It helps users distinguish smart-money and whale activity from fresh-wallet flows; holder lookup requires a token contract address.

Key features

  1. 01List token holders and their labels
  2. 02Review holder value and ownership share
  3. 03Track balance changes over time
  4. 04Compare flows by wallet label

Use cases

  1. 01Assess whether token holders include smart traders
  2. 02Compare whale and fresh-wallet activity
  3. 03Flag high fresh-wallet flows with few smart-money holders

Install

Copy the command and run it in a terminal.

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

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

Details

From the project README

Holder Quality

Answers: "Is this token held by quality wallets or retail noise?"

TOKEN=<address> CHAIN=ethereum

nansen research token holders --token $TOKEN --chain $CHAIN --smart-money --limit 20
# → address, address_label, value_usd, ownership_percentage, balance_change_24h/7d/30d

nansen research token flow-intelligence --token $TOKEN --chain $CHAIN
# → net_flow_usd and wallet_count per label: smart_trader, whale, exchange, fresh_wallets

nansen research token who-bought-sold --token $TOKEN --chain $CHAIN --limit 20
# → address, address_label, bought/sold_volume_usd, bought/sold_token_volume, trade_volume_usd

Red flag: high fresh_wallets flow + low SM holders. Green flag: Fund/Smart Trader labels in top 20.

Note: holders endpoint does not support native/wrapped tokens. Use a specific token contract address.

Comments

Markdown supported