Skip to content

A simple Python script to retrieve Owners/Holders of a whole NFT collection on ETH (OpenSea)

Notifications You must be signed in to change notification settings

gbe3hunna/Opensea-Owners-Checker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Opensea-Owners-Checker

image

A simple Python script to retrieve Owners/Holders of a whole NFT collection on ETH (OpenSea).

Created for DOS PUNKS Community to thank @maxcapacity and @greencrosslive all their effort to build such a strong DOS world.

This script can be useful for any NFT project staff to Snapshot the actual holders

Installation

1) git clone https://github.com/gbe3hunna/Opensea-Owners-Checker.git

2) cd Opensea-Owners-Checker

3) pip install -r requirements.txt -U

Other requirements

  • OpenSea Collection Path/Slug
    • Example: https://opensea.io/collection/dos-punks --> dos-punks
  • Contract Address
    • Example: https://opensea.io/collection/dos-punks --> 0x495f947276749ce646f68ac8c248420045cb7b5e
  • Total Minted / Total Collection Tokens
    • Example: https://opensea.io/collection/dos-punks --> 497
  • Moralis Web3 API Key (FREE)

Usage

Running with user input

python os-checker.py
  • Fill the inputs with your data
  • Filter is OPTIONAL (Example: 2 If you want to filter by holders with 2 or more tokens...)

Running with flags

-s, --slug / Slug
-c, --contract / Contract Address
-m, --minted / Total Minted - Total Collection Tokens
-k, --apikey / Moralis Web3 API Key
-f, --filter (OPTIONAL) / Filter by Tokens (2 If you want to filter by holders with 2 or more tokens...)
  • Type python os-checker.py -h to get the available flags

Results

  • It will generate a JSON file inside ./snapshots directory.
  • Will follow the next Schema:
    • Wallet Address: Number of tokens

About

A simple Python script to retrieve Owners/Holders of a whole NFT collection on ETH (OpenSea)

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages