nansen-holder-quality

Calculate smart money ratio and analyze token holder flow intelligence.

127|21|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/nansen-ai/nansen-cli --skill nansen-holder-quality
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nansen-holder-quality
Source: https://github.com/nansen-ai/nansen-cli/tree/main/skills/nansen-holder-quality
Command: npx skills add https://github.com/nansen-ai/nansen-cli --skill nansen-holder-quality

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps determine if a token is primarily held by sophisticated investors ("quality wallets") or by less experienced traders ("retail noise"), providing insights into the token's investor base.

Core Features & Use Cases

  • Smart Money Ratio: Analyzes the proportion of tokens held by wallets labeled as "smart money" or "smart traders".
  • Flow Intelligence: Breaks down token inflows and outflows by wallet labels (e.g., whale, exchange, fresh wallets) to understand recent activity.
  • Buyer/Seller Analysis: Identifies recent buyers and sellers of the token, along with their associated labels and trading activity.
  • Use Case: Before investing in a new token, use this Skill to quickly gauge whether the smart money is accumulating or if the token is dominated by retail speculation.

Quick Start

Evaluate the holder quality for the token at address 0x123... using the Ethereum chain.

Frequently Asked Questions about nansen-holder-quality

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze token holder quality using on-chain data?

To analyze token holder quality, calculate the smart money ratio and examine flow intelligence alongside recent buyer and seller activity. This approach reveals whether sophisticated investors or retail traders dominate the token's investor base.

What is smart money ratio in cryptocurrency investment research?

Smart money ratio measures the proportion of tokens held by wallets labeled as smart money or smart traders. It helps determine if a token is primarily held by sophisticated investors or dominated by retail speculation.

How do I check if smart money is accumulating a specific crypto token?

You can check smart money accumulation by breaking down token inflows and outflows by wallet labels using flow intelligence. This identifies recent buyers and sellers along with their associated trading activity.

Do I need a Nansen API key to assess token holder quality?

Yes, you need Nansen API access to query token holder data, flow intelligence, and transaction history. The API is required to retrieve the on-chain data necessary for calculating smart money ratios.

Can I use this holder quality analysis on any blockchain?

Yes, token holder quality analysis is applicable to cryptocurrency investment research and portfolio analysis on various blockchains. You must provide the specific token address and chain name to query the data.

What's the best way to evaluate token holder quality before investing?

The best way to evaluate token holder quality is to combine smart money ratio analysis with recent buyer and seller activity. This quickly gauges whether smart money is accumulating or if the token is driven by retail noise.