# NFT Holders Snapshots

## Current and Past Snapshots of NFT Holders.

Take a snapshot of the **current** or **past** (from a **specific date/block**) owners of your collection, including holders, tokenList, and more. Download the snapshot in JSON to parse in the future or use it in our tools as a way of [Token Gating](https://mintpad.gitbook.io/docs/features/token-gating).

Thanks to this tool, you can obtain a list of wallets holding your collection's NFTs on the current date, either to consult it or to use this information in other applications/websites, perform airdrops to those wallets, etc. You can also compare which owners have changed, which ones are new, or which ones **have been minted from a specific date onward**.

Also, you can **check** which **tokens** are **sold**.

Below you have a snapshot example:

<figure><img src="https://4118262152-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtP38LX7mJsfWKTrriMU4%2Fuploads%2Fgit-blob-5171e5f42a5560c3c478c8f79335f069c6f91cd8%2Fimage%20(95).png?alt=media" alt=""><figcaption></figcaption></figure>

Let's see how to use this tool:

First, we see a selector that switches from "Current block" to "Past snapshot." By default, the "Current block" option is selected, which means that you will obtain actual information.

<figure><img src="https://4118262152-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtP38LX7mJsfWKTrriMU4%2Fuploads%2Fgit-blob-3d44dbc44758eb1492ccbb40ce20dd3d46943048%2Fimage%20(150).png?alt=media" alt=""><figcaption></figcaption></figure>

The past snapshot option asks for a custom date and time. You will obtain the collection information for that specific date.

<figure><img src="https://4118262152-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtP38LX7mJsfWKTrriMU4%2Fuploads%2Fgit-blob-f2d9bc06cb433e42edd95a81260e949642129b5a%2Fimage%20(151).png?alt=media" alt=""><figcaption></figcaption></figure>

When you request a snapshot and everything goes well, you receive something like this:

<figure><img src="https://4118262152-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtP38LX7mJsfWKTrriMU4%2Fuploads%2Fgit-blob-62b54e0747f31630de0b3310a24ce1362a255869%2Fimage%20(152).png?alt=media" alt=""><figcaption></figcaption></figure>

You can update the information by requesting a new blockchain snapshot by clicking on 'Re-take snapshot'.

Furthermore, you can download that snapshot as a JSON file. If you need, you can process it manually or automatically.

Let's examine the structure of the information you will receive:

<figure><img src="https://4118262152-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtP38LX7mJsfWKTrriMU4%2Fuploads%2Fgit-blob-a13a0536712e9330a279a416a7ea7ea9514e6c35%2Fimage%20(157).png?alt=media" alt=""><figcaption></figcaption></figure>

* **ContractAddress**: The address of the smart contract associated with the NFT collection.
* **BlockNumber**: Last block.
* **Timestamp**: The Unix timestamp representing the time when the information was recorded.
* **Stats**: An object containing statistics related to the collection of NFTs.
  * **Total\_nfts**: The total number of NFTs minted.
  * **unique\_owners**: The number of unique owners of the NFTs in that collection.
  * **unique\_owners\_percentage**: The percentage of unique owners among all NFT holders.
  * **contract\_creation\_blocknumber**: The block number at which the contract was created.
* **Holders**: An array containing information about NFT holders.
  * **Owner**: The address of the NFT holder.
  * **Amount**: The number of NFTs held by the owner.
  * **Tokens**: An array containing information about individual tokens that the owner holds. You can see the NFT identifier in the collection.
* **Tokenlist**: An array containing information about lists of tokens in the collection. It only shows NFTs that have been minted and held by someone.
  * **TokenId**: The unique identifier of the token in this collection.
  * **Owner**: The address of the token owner.

Tokens not listed have not been minted.

{% hint style="info" %}
These tools can be used as a manual token-gating method. For integrated Token-Gating functionality, visit the add-on section. You can download the JSON and process it manually or using a script.
{% endhint %}