Skip to main content

Documentation Index

Fetch the complete documentation index at: https://apetopia.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Community Health gives you a single score (0–100) that summarizes the on-chain health of your NFT collection. Instead of digging through raw holder data, you get one number that tells you at a glance whether your holders are staying loyal, whether the supply is well-distributed, and whether the collection is growing.

Open in Apetopia →

Go directly to this feature in your dashboard.
Access Community Health from NFT Suite → Collection Analytics → Community Health in your dashboard sidebar.
Community Health requires at least one Holder Snapshot. Go to Holder Snapshot and run a scan first if you haven’t yet.

How the score is calculated

The score is a weighted combination of four components:
ComponentWhat it measures
RetentionWhat percentage of past holders are still holding
ConcentrationHow evenly the supply is spread (high whale concentration lowers the score)
GrowthNet change in unique holders between snapshots
Diamond HandsPercentage of holders who have held through multiple snapshots
Each component is scored 0–100 and weighted to produce the final score.

Score ranges

ScoreLabelWhat it means
75 – 100HealthyLoyal holders, good distribution, positive momentum
50 – 74ModerateSolid base but some signals to watch
25 – 49At RiskNotable holder exits or concentration concerns
0 – 24CriticalSignificant sell pressure or distribution problems — action recommended

Stats panel

Alongside the score, you’ll see a quick-stats breakdown:
  • Unique holders — total wallets currently holding
  • Total NFTs tracked — NFTs included in the latest snapshot
  • Single-NFT holders — percentage of holders with only 1 NFT (higher = more fragile)
  • Whales — holders above the whale threshold (≥1% of supply)
  • Top 10 concentration — percentage of supply held by the top 10 wallets
Top 10 concentration above 40% is flagged as a warning — high concentration means a few wallets exiting can significantly impact the collection.

Retention cohort tracking (Pro)

Pro communities get a cohort table showing how many holders from each past snapshot are still holding today. This is the most accurate signal of long-term loyalty. Each row shows:
  • The snapshot date (cohort)
  • How many holders were in that cohort
  • How many are still holding
  • The retention rate as a percentage and bar
The latest snapshot doesn’t have a retention rate yet — there’s no future snapshot to compare it to. It shows ”—” until a newer snapshot is taken.

Reading the score guide

Two signals to watch:
  • Good signal — high retention + high diamond hands + score above 75 → community is loyal and holding long-term
  • Warning signal — high exits + low retention + score below 50 → consider running engagement campaigns or holder incentives

Tips

  • Run snapshots regularly (weekly or monthly) to get accurate retention and growth scores. A single snapshot produces estimated values.
  • Use the score alongside Sell Pressure and Wallet Overlap for a complete picture of holder behavior.
  • If concentration is high, consider incentives that reward smaller holders to balance the distribution.