🌆NFT Holders Snapshots

Current and Past Snapshots of NFT Holders

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.

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:

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.

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

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

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:

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

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.