HomeKnowledge BaseHow to analyze token holder distribution with Dune

How to analyze token holder distribution with Dune

10 min read
·
Published Apr 29, 2025, 7:12 AM

Token holder distribution refers to how tokens are spread across different wallet addresses. This distribution pattern indicates whether a token has centralized ownership among few large holders or decentralized ownership across many smaller holders. The analysis helps investors assess investment risks, project teams understand their community composition, and researchers evaluate token economics.

Key distribution metrics include total unique holders, holder growth over time, concentration ratios among top holders, and statistical measures like median holdings. These metrics provide a comprehensive view of token ownership patterns and their implications for price stability and market dynamics.

Setting up your Dune analysis framework

Begin by creating a Dune account and accessing the query interface. The platform's data catalog contains pre-indexed blockchain data from multiple networks including Ethereum, Polygon, Solana, and others. Token holder data typically resides in token transfer tables and balance calculation views.

For Ethereum-based tokens, the primary data source is the ERC20 token transfers table, which records all token movement transactions. Solana token data exists in separate tables specific to that blockchain's architecture. Understanding which tables contain your target token's data is essential before writing queries.

Consider the specific token you want to analyze. For example, analyzing USDC distribution on Ethereum would require querying the transfers table filtered by USDC's contract address. The query would aggregate transfer data to calculate current balances for each holding address.

Identifying key holder distribution metrics

Total unique holders represents the most fundamental metric, counting distinct addresses holding any amount of tokens. This number indicates adoption breadth but does not reveal concentration patterns. A token with 100,000 holders appears widely adopted, but if 90% of supply sits in 10 wallets, concentration risk remains high.

Holder growth rates show adoption momentum. Track daily or weekly new holder additions alongside holder departures. Rapid growth periods often coincide with marketing campaigns or token listing events, while declining holder counts may signal waning interest.

Top holder concentration measures what percentage of total supply the largest holders control. Common thresholds examine the top 10, 50, or 100 holders' combined ownership percentage. A healthy distribution typically shows top 100 holders controlling less than 50% of circulating supply.

Creating distribution tier analysis

Segment holders into meaningful categories based on holding amounts. Common tiers include retail holders with less than $1,000 worth, mid-tier holders with $1,000 to $100,000, and whale holders above $100,000. These dollar-based tiers require incorporating token price data alongside balance calculations.

Alternative tier structures use token quantity thresholds. For example, categorize holders of a governance token into tiers of 1-100 tokens, 101-1,000 tokens, 1,001-10,000 tokens, and above 10,000 tokens. These quantity-based tiers remain consistent regardless of price fluctuations.

Consider an analysis of a DeFi token where 85% of holders own fewer than 500 tokens, 12% hold between 500-5,000 tokens, 2.8% hold between 5,000-50,000 tokens, and 0.2% hold more than 50,000 tokens. This distribution suggests reasonable decentralization with limited whale concentration.

Analyzing whale behavior patterns

Large holders significantly influence token price and liquidity. Track whale accumulation and distribution patterns to understand market sentiment among informed investors. Identify addresses consistently accumulating tokens over time versus those reducing positions.

Create whale activity dashboards showing recent large transactions, whale balance changes over time, and correlations between whale movements and price action. For instance, if five whale addresses simultaneously reduce holdings by 20%, this pattern suggests coordinated selling pressure.

Monitor whale holding duration to distinguish between long-term believers and short-term speculators. Calculate average holding periods for different wallet size categories. Whales holding tokens for over one year demonstrate stronger conviction than those with frequent trading activity.

Examining holder behavior patterns

Long-term holder analysis identifies addresses that purchase tokens and maintain positions, indicating strong conviction. Query for addresses with minimal selling activity over specific time periods. High percentages of long-term holders suggest a committed community willing to hold through market volatility.

Track holder retention rates by analyzing how many addresses continue holding tokens after initial purchase across different time horizons. Calculate 30-day, 90-day, and 365-day retention rates. Strong projects typically show retention rates above 60% at 90 days.

Accumulation pattern analysis reveals whether existing holders increase positions during price declines. Identify addresses consistently adding to positions during market downturns. This behavior indicates sophisticated holders using dollar-cost averaging strategies.

Building comprehensive distribution dashboards

Effective distribution dashboards combine multiple visualizations to tell a complete story. Include holder count trends over time, distribution tier pie charts, top holder tables, and whale activity timelines. Each visualization should answer specific questions about token ownership patterns.

Create interactive elements allowing users to filter by date ranges, holder size tiers, or specific metrics. For example, enable filtering to show only holders with positions above $10,000 or exclude known exchange addresses from calculations.

An NFT project token dashboard might display total holders growing from 5,000 to 12,000 over six months, top 20 holders controlling 35% of supply, and 70% of holders maintaining positions for over 60 days. These metrics suggest healthy growth with reasonable concentration levels.

Interpreting distribution health signals

Healthy token distributions typically show growing holder counts, decreasing concentration among top holders over time, and strong retention rates. Warning signs include static or declining holder numbers, increasing whale concentration, and high holder churn rates.

Compare distribution metrics against similar projects or industry benchmarks. A DeFi governance token with 500 holders appears limited compared to established protocols with 50,000+ holders. However, rapid growth from 100 to 500 holders in three months indicates positive momentum.

Monitor distribution changes during significant events like token listings, protocol updates, or market crashes. Healthy communities often show resilient holder metrics during adverse conditions, while fragile projects experience rapid holder departures.

Advanced analysis techniques

Implement cohort analysis to track holder behavior based on acquisition timing. Compare retention and accumulation patterns between holders who acquired tokens during different market conditions. Early adopters often display different behavior patterns than late-stage buyers.

Cross-reference holder addresses with other protocol activities to understand holder engagement levels. Addresses actively using the underlying protocol demonstrate stronger commitment than passive holders. This analysis requires joining token balance data with protocol usage data.

Statistical analysis provides deeper insights into distribution characteristics. Calculate Gini coefficients to measure inequality levels, standard deviations to assess concentration patterns, and correlation coefficients between holder metrics and price movements.

Token holder distribution analysis through Dune empowers data-driven decision making in cryptocurrency investments and project management. The platform's comprehensive blockchain data access and visualization capabilities enable thorough examination of ownership patterns that traditional financial analysis tools cannot provide. Regular monitoring of distribution metrics reveals important trends about community health, adoption momentum, and potential market risks that inform strategic decisions.

Frequently asked questions

What is token holder distribution and why is it important for crypto analysis?

Token holder distribution refers to how tokens are spread across different wallet addresses within a crypto project. This metric is crucial because it reveals whether a token has centralized ownership among a few large holders (whales) or decentralized ownership across many smaller holders. Understanding distribution patterns helps investors assess investment risks, enables project teams to understand their community composition, and allows researchers to evaluate tokenomics health. A well-distributed token typically indicates a healthier, more stable ecosystem with reduced manipulation risk.

What are the key metrics to analyze when studying token holder distribution?

The most important distribution metrics include total unique holders (showing adoption breadth), holder growth rates over time (indicating momentum), top holder concentration ratios (measuring centralization risk), and statistical measures like median holdings. Additionally, you should track whale behavior patterns, retention rates across different time periods, and accumulation patterns during market downturns. These metrics provide a comprehensive view of token ownership patterns and their implications for price stability and market dynamics.

How do you set up token holder analysis using blockchain data?

To analyze token holder distribution, you need access to blockchain data through platforms like Dune Analytics. The process involves querying token transfer tables and balance calculation views from networks like Ethereum, Polygon, or Solana. For Ethereum-based ERC20 tokens, you'll primarily use the token transfers table filtered by the specific contract address. The analysis requires aggregating transfer data to calculate current balances for each holding address and tracking changes over time.

What constitutes healthy token distribution patterns?

Healthy token distributions typically show growing holder counts over time, decreasing concentration among top holders, and strong retention rates above 60% at 90 days. Generally, top 100 holders should control less than 50% of circulating supply. Red flags include static or declining holder numbers, increasing whale concentration, and high holder churn rates. A balanced distribution often shows the majority of holders (around 85%) owning smaller amounts, with progressively fewer holders in larger tiers.

How should you categorize different types of token holders?

Token holders are commonly segmented into meaningful tiers based on holding amounts. Typical categories include retail holders (less than $1,000 worth), mid-tier holders ($1,000 to $100,000), and whale holders (above $100,000). Alternatively, you can use token quantity thresholds that remain consistent regardless of price fluctuations. For governance tokens, common tiers might be 1-100 tokens, 101-1,000 tokens, 1,001-10,000 tokens, and above 10,000 tokens.

What is whale behavior analysis and why does it matter?

Whale behavior analysis involves tracking large holders who significantly influence token price and liquidity. This includes monitoring whale accumulation and distribution patterns, identifying addresses consistently accumulating versus those reducing positions, and analyzing holding duration to distinguish long-term believers from short-term speculators. Whale movements often correlate with price action, so understanding their behavior patterns helps predict potential market movements and assess overall market sentiment among informed investors.

What are diamond hands and how do you measure holder conviction?

Diamond hands refer to holders who purchase tokens but never sell, indicating strong conviction in the project. You can measure this by identifying addresses with only incoming transfers and no outgoing transfers over specific time periods. High diamond hand percentages suggest a committed community willing to hold through market volatility. Additionally, tracking holder retention rates at 30-day, 90-day, and 365-day intervals helps measure overall community conviction and project health.

How do you interpret distribution health signals for DeFi projects?

For DeFi projects, healthy distribution signals include growing holder counts, reasonable concentration levels among top holders, and strong community engagement with the underlying protocol. Compare distribution metrics against similar projects or industry benchmarks - for example, established DeFi protocols typically have 50,000+ holders. Monitor how distribution changes during significant events like token listings, protocol updates, or market crashes. Healthy DeFi communities often show resilient holder metrics during adverse conditions.

What advanced techniques can enhance token distribution analysis?

Advanced analysis techniques include cohort analysis to track holder behavior based on acquisition timing, cross-referencing holder addresses with protocol usage data to measure engagement levels, and implementing statistical measures like Gini coefficients to measure inequality levels. You can also calculate correlation coefficients between holder metrics and price movements, and perform time-series analysis to identify trends and patterns in distribution changes over different market cycles.