Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
nansen-ai avatar

Nansen Holder Analysis

  • 349 installs
  • 127 repo stars
  • Updated August 4, 2026
  • nansen-ai/nansen-cli

nansen-holder-analysis is a Claude agent skill that analyzes token holder concentration, cohort changes, and wallet labels via Nansen CLI for developers assessing growth, risk, and community quality of crypto tokens.

About

nansen-holder-analysis is a skill from nansen-ai/nansen-cli that answers whether a token is held by quality wallets or retail noise. It executes nansen research token holders with --token, --chain, --smart-money, and --limit 20, returning address, address_label, value_usd, ownership_percentage, and balance data for top labeled holders. The skill requires NANSEN_API_KEY and the nansen CLI from npm. Crypto product developers, risk analysts, and agent builders use nansen-holder-analysis to gauge smart-money holder ratio, flow breakdown by label, and recent buyer quality before growth campaigns or risk sizing. Bash nansen:* commands are the allowed execution path.

  • Holder concentration
  • Labeled wallet cohorts
  • Token distribution metrics
  • Nansen CLI reports
  • Community risk signals

Nansen Holder Analysis by the numbers

  • 349 all-time installs (skills.sh)
  • +3 installs in the week ending Aug 4, 2026 (Skillselion tracking)
  • Ranked #53 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-holder-analysis

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs349
repo stars127
Last updatedAugust 4, 2026
Repositorynansen-ai/nansen-cli

How do you analyze token holder quality with Nansen?

Analyze token holder concentration, cohort changes, and wallet labels via Nansen CLI to inform growth, risk, and community strategy for crypto products.

Who is it for?

Crypto developers and analysts who need Nansen-labeled holder concentration data to inform token risk, growth, and community strategy.

Skip if: Non-crypto assets, teams without Nansen API access, or deep contract audit work unrelated to holder wallet labels.

When should I use this skill?

The user asks about token holder quality, smart-money ratio, holder concentration, or wallet labels for a specific token.

What you get

Top 20 holder records with address labels, value_usd, ownership_percentage, and smart-money cohort quality assessment.

  • holder table with labels
  • ownership concentration metrics

By the numbers

  • Returns up to 20 smart-money token holders per query via --limit 20

Files

SKILL.mdMarkdownGitHub ↗

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.

Related skills

How it compares

Choose nansen-holder-analysis over generic block explorers when labeled smart-money holder ratios and ownership percentages are needed.

FAQ

How many holders does nansen-holder-analysis return?

nansen-holder-analysis queries nansen research token holders with --limit 20 and --smart-money. Each row includes address, address_label, value_usd, ownership_percentage, and balance fields.

What question does nansen-holder-analysis answer?

nansen-holder-analysis answers whether a token is held by quality wallets or retail noise by reporting smart-money holder ratio, flow breakdown by label, and recent buyer quality via Nansen CLI.

Web3 & Blockchainanalyticsdatabases

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.