$
node -v

$
mkdir nft-minter-getter && cd nft-minter-getter
>
npm init -y
>
npm install --save alchemy-sdk
>
touch main.js

1
// importing the Alchemy SDK
2
const { Alchemy, Network } = require("alchemy-sdk");
3
4
// configuring the Alchemy SDK
5
const config = {
6
  apiKey: "demo", // Replace with your Alchemy API Key.
7
  network: Network.ETH_MAINNET, // Replace with the network your NFT contract is deployed to.
8
};
9
const alchemy = new Alchemy(config);
10
11
// This is the address of the BAYC NFT Contract
12
const nftAddress = "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"; // Replace with your NFT contract address.
13
14
// Creating an empty array to store the minters of the NFT Collection
15
let minters = [];
16
17
let pageKey; // Variable for pageKey that will be used to paginate through the API call.
18
19
// function to get all the minters of the NFT Collection
20
async function getMinters() {
21
  // Boolean variable to check if it is the first call to the API call.
22
  // We need this because the first time we make the API call, the pageKey will be undefined.
23
  let firstCall = true;
24
25
  // Looping through the API call until the pageKey is not null/undefined.
26
  while (firstCall || pageKey) {
27
    let res;
28
    if (pageKey) {
29
      // Making a call to the getAssetTransfers method to get all the transfers in which the `fromAddress` is 0x0000000000000000000000000000000000000000
30
  		// If the `fromAddress` is 0x0000000000000000000000000000000000000000, it means that the NFT was minted to the `toAddress` in the transfer.
31
      res = await alchemy.core.getAssetTransfers({
32
        fromAddress: "0x0000000000000000000000000000000000000000",
33
        category: ["erc721"], // Replace with the category of your NFT contract. BAYC is an ERC721 token.
34
        contractAddresses: [nftAddress], // Replace with the address of your NFT contract.
35
        pageKey: pageKey, // The pageKey is used to paginate through the API call.
36
      });
37
    } else {
38
      // Making a call to the getAssetTransfers method to get all the transfers in which the `fromAddress` is 0x0000000000000000000000000000000000000000
39
 		 // If the `fromAddress` is 0x0000000000000000000000000000000000000000, it means that the NFT was minted to the `toAddress` in the transfer.
40
      res = await alchemy.core.getAssetTransfers({
41
        fromAddress: "0x0000000000000000000000000000000000000000",
42
        category: ["erc721"], // Replace with the category of your NFT contract. BAYC is an ERC721 token.
43
        contractAddresses: [nftAddress], // Replace with the address of your NFT contract.
44
      });
45
    }
46
47
    firstCall = false; // Setting the `firstCall` variable to false, because it is not the first call anymore.
48
49
    // The API call returns an object with a `transfers` key, which is an array of all the transfers.
50
51
    // Looping through the response of the API call, that is, the transfers and pushing the `to` address to the `minters` array.
52
    // Because the `to` is the address that minted the NFT.
53
    for (let i = 0; i < res.transfers.length; i++) {
54
      const transfer = res.transfers[i];
55
      minters.push(transfer.to); // adding the `to` address to the `minters` array.
56
    }
57
58
    pageKey = res.pageKey; // Setting the pageKey from the response of the API call.
59
  }
60
61
  minters = [...new Set(minters)]; // Removing the duplicate addresses from the `minters` array. This is done because the API call returns the same `to` address multiple times if an address minted multiple NFTs.
62
  console.log("Number of unique minters:", minters.length);
63
  console.log(minters); // Printing the `minters` array.
64
}
65
66
async function main() {
67
  await getMinters(); // Calling the `getMinters` function.
68
}
69
70
main();

$
node main.js

1
// importing the Alchemy SDK
2
const { Alchemy, Network } = require("alchemy-sdk");
3
4
// configuring the Alchemy SDK
5
const config = {
6
  apiKey: "demo", // Replace with your Alchemy API Key.
7
  network: Network.ETH_MAINNET, // Replace with the network your NFT contract is deployed to.
8
};
9
const alchemy = new Alchemy(config);
10
11
// This is the address of the BAYC NFT Contract
12
const nftAddress = "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"; // Replace with your NFT contract address.
13
14
// Creating an empty array to store the minters of the NFT Collection
15
let minters = [];
16
17
let pageKey; // Variable for pageKey that will be used to paginate through the API call.
18
19
// function to get all the minters of the NFT Collection
20
async function getMinters() {
21
  // Boolean variable to check if it is the first call to the API call.
22
  // We need this because the first time we make the API call, the pageKey will be undefined.
23
  let firstCall = true;
24
25
  // Looping through the API call until the pageKey is undefined.
26
  while (firstCall || pageKey) {
27
    let res;
28
    if (pageKey) {
29
      // Making a call to the getAssetTransfers method to get all the transfers in which the `fromAddress` is 0x0000000000000000000000000000000000000000
30
      // If the `fromAddress` is 0x0000000000000000000000000000000000000000, it means that the NFT was minted to the `toAddress` in the transfer.
31
      res = await alchemy.core.getAssetTransfers({
32
        fromAddress: "0x0000000000000000000000000000000000000000",
33
        category: ["erc721"], // Replace with the category of your NFT contract. BAYC is an ERC721 token.
34
        contractAddresses: [nftAddress], // Replace with the address of your NFT contract.
35
        pageKey: pageKey, // The pageKey is used to paginate through the API call.
36
      });
37
    } else {
38
      // Making a call to the getAssetTransfers method to get all the transfers in which the `fromAddress` is 0x0000000000000000000000000000000000000000
39
      // If the `fromAddress` is 0x0000000000000000000000000000000000000000, it means that the NFT was minted to the `toAddress` in the transfer.
40
      res = await alchemy.core.getAssetTransfers({
41
        fromAddress: "0x0000000000000000000000000000000000000000",
42
        category: ["erc721"], // Replace with the category of your NFT contract. BAYC is an ERC721 token.
43
        contractAddresses: [nftAddress], // Replace with the address of your NFT contract.
44
      });
45
    }
46
47
    firstCall = false; // Setting the `firstCall` variable to false, because it is not the first call anymore.
48
49
    // The API call returns an object with a `transfers` key, which is an array of all the transfers.
50
51
    // Looping through the response of the API call, that is, the transfers and pushing the `to` address to the `minters` array.
52
    // Because the `to` is the address that minted the NFT.
53
    for (let i = 0; i < res.transfers.length; i++) {
54
      const transfer = res.transfers[i];
55
      minters.push(transfer.to); // adding the `to` address to the `minters` array.
56
    }
57
58
    pageKey = res.pageKey; // Setting the pageKey from the response of the API call.
59
  }
60
61
  minters = [...new Set(minters)]; // Removing the duplicate addresses from the `minters` array. This is done because the API call returns the same `to` address multiple times if an address minted multiple NFTs.
62
  console.log("Number of unique minters:", minters.length);
63
}
64
65
async function checkIfHolder() {
66
  // Variable to store the number of minters who are still holding an NFT from the Collection.
67
  let holdingDay1Minters = 0;
68
69
  // Getting the current owners of the NFT Collection.
70
  let currentOwnersResponse = await alchemy.nft.getOwnersForContract(
71
    nftAddress
72
  );
73
  let currentOwners = currentOwnersResponse.owners; // Getting the `owners` array from the response.
74
75
  // Looping through the `minters` array and checking if they still hold an NFT from the Collection
76
  for (let i = 0; i < minters.length; i++) {
77
    const minter = minters[i]; // Getting the address of the minter.
78
79
    // If the minter is present in the `currentOwners` array, it means that the minter still holds an NFT from the Collection.
80
    if (currentOwners.includes(minter)) {
81
      holdingDay1Minters++; // Incrementing the `holdingDay1Minters` variable by 1.
82
    }
83
  }
84
85
  console.log(
86
    "Number of day 1 minters who are still holding the NFT:",
87
    holdingDay1Minters
88
  );
89
  console.log(
90
    "Percentage of day 1 minters who are still holding the NFT:",
91
    ((holdingDay1Minters / minters.length) * 100).toFixed(2), // Stripping down the percentage to 2 decimal places.
92
    "%"
93
  );
94
}
95
96
async function main() {
97
  await getMinters(); // Calling the `getMinters` function.
98
  await checkIfHolder(); // Calling the `checkIfHolder` function.
99
}
100
101
main();

node main.js