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

# Holders

> Run an on-chain snapshot of every wallet holding your NFTs and download the full list.

The Holders page lets you scan the blockchain and get a real-time list of every wallet currently holding NFTs from your collection — including wallets that have never interacted with your Discord. This is the source of truth for your holder base.

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

<Note>
  This is a **Pro** plan feature.
</Note>

## Running a snapshot

1. Go to **NFT Suite → Core → Holders**
2. Select the collection you want to scan
3. Click **Run Snapshot**

Apetopia queries the blockchain directly and returns the complete list of current holders with their wallet addresses and NFT counts. Snapshots are limited to once every 2 hours per collection to avoid excessive on-chain reads.

<Info>
  This is a full on-chain scan — it includes **all** holders, not just members who have verified their wallet in your Discord.
</Info>

## Downloading the holder list

Once a snapshot is complete, click the **Export** button to download in three formats:

| Format                | File                         | Contents                                                   |
| --------------------- | ---------------------------- | ---------------------------------------------------------- |
| **Holders CSV**       | `collection-holders.csv`     | `wallet, nfts` — one row per wallet with their NFT count   |
| **Wallets TXT**       | `collection-wallets.txt`     | Plain list of wallet addresses, one per line               |
| **Hash → Wallet CSV** | `collection-hash-wallet.csv` | `mint_address, holder_wallet` — one row per individual NFT |

The **Wallets TXT** format is what most airdrop tools expect. The **Hash → Wallet CSV** is useful if you need to know which specific NFTs are in which wallet.

## Snapshot history

Every snapshot is saved automatically. You can reload a previous snapshot at any time from the history panel — useful for comparing holder distribution over time or re-downloading an older list without running a new scan.

## Wallet detail

Click any wallet in the list to open a detail panel showing:

* The full wallet address (with a copy button)
* NFTs held from your collection
* Other NFT collections this wallet holds (Pro)
* Tags and private notes you can attach to the wallet (CRM)

## Search and filter

Use the search bar to look up a specific wallet address within the current snapshot results.

<Tip>
  Run a snapshot before setting up a Holder Raffle or Airdrop to make sure you're working with current on-chain data.
</Tip>