> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apetopia.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Community Health

> A health score for your NFT collection based on holder retention, concentration, growth, and diamond hands.

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.

<Card title="Open Community Health →" href="https://www.apetopia.co/dashboard/insights/health">
  Go directly to this feature in your dashboard.
</Card>

<Note>
  This is a **Pro** plan feature. You need at least one Holder Snapshot before data appears here — go to [**Holder Snapshot**](https://www.apetopia.co/dashboard/holders) and run a scan first.
</Note>

## How the score is calculated

The score is a weighted combination of four components:

| Component         | What it measures                                                            |
| ----------------- | --------------------------------------------------------------------------- |
| **Retention**     | What percentage of past holders are still holding                           |
| **Concentration** | How evenly the supply is spread (high whale concentration lowers the score) |
| **Growth**        | Net change in unique holders between snapshots                              |
| **Diamond Hands** | Percentage of holders who have held through multiple snapshots              |

Each component is scored 0–100 and weighted to produce the final score.

## Score ranges

| Score        | Label    | What it means                                                           |
| ------------ | -------- | ----------------------------------------------------------------------- |
| **75 – 100** | Healthy  | Loyal holders, good distribution, positive momentum                     |
| **50 – 74**  | Moderate | Solid base but some signals to watch                                    |
| **25 – 49**  | At Risk  | Notable holder exits or concentration concerns                          |
| **0 – 24**   | Critical | Significant 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

<Warning>
  Top 10 concentration above 40% is flagged as a warning — high concentration means a few wallets exiting can significantly impact the collection.
</Warning>

## Holder Retention History

This table answers one question per row: *of the wallets that held NFTs on that date, how many are still holding today?*

It works by comparing each past snapshot's wallet list against today's list, wallet by wallet. If a wallet that was holding on May 25 is still holding on Jun 8, it counts as retained. If it's gone — it sold or transferred out.

| Column                  | What it shows                                                    |
| ----------------------- | ---------------------------------------------------------------- |
| **Snapshot date**       | When that snapshot was taken                                     |
| **Holders**             | How many unique wallets held NFTs at that time                   |
| **Still holding today** | How many of those exact same wallets are still holding right now |
| **Retention**           | Still holding today ÷ Holders, as a percentage                   |

**Example:** a row showing May 25 · 780 holders · 779 still holding today · 100% means: of the 780 wallets that held an NFT on May 25, 779 of them are still holding as of the latest snapshot. Only 1 wallet left.

Every row uses the same reference point — today's snapshot. This lets you see not just recent churn, but long-term loyalty across all your historical snapshots.

<Info>
  The latest snapshot always shows "—" for retention — it is the reference point everything else is compared against. Once you take a new snapshot, that row will start showing a retention rate.
</Info>

## 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.