How to Listen to NFT Mints

How to use the Alchemy Subscription API to track successful NFT mint events.

How to track NFT mints in 5 easy steps

In this guide, we will write a script to fetch real-time updates whenever anyone mints a new NFT.

These updates can be pushed to your website, server, etc. Collections like Bored Ape Yacht Club are sold out, but projects like Chibi Shinobis or HackrDAO NFTs are brand new.

So how do we watch the mints for newer projects that are still minting?

Let’s write a script!

1. Grab an Alchemy API key

Go to the Alchemy website and sign up for an account if you don’t yet have an account.

In your app dashboard, click on “View Key” to grab your dedicated app RPC connection API key. We will need this API Key in order to access the Alchemy Subscription API.

The most important consideration for this step is to use an app that corresponds to the correct blockchain on which your desired NFT contract lives.

For example, this HackrDAO test NFT contract was deployed on the Goerli test network. So if we want to track mint events for that contract, we need our app to be configured for the Goerli testnet.

On which chains can I use the Alchemy Subscription API?

Please reference this page to stay up-to-date on which networks we support:

Feature Support By Chain

2. Find your desired NFT smart contract address

Every smart contract deployed to a smart contract has an address. It is the unique identifier that allows anyone to look up details about that particular contract.

Again, using this HackrDAO test NFT contract as an example, we can see that its address on the Goerli testnet is 0xBD34d145fcFD3992a0dEf1057891D51339a90128.

3. Install a web3 library

For this guide, we will use modern web3 libraries to subscribe to and listen to Log events. We recommend Viem for new projects, or Ethers.js if you’re already familiar with it.

$
npm install viem

4. Define your event log topic filters!

Defining Log topic event filters is the step where we construct a “query” for the information we want from the API.

There are two concepts you should know about in order to navigate the Subscription API successfully:

1. Subscription Types
2. Log Topics

If you already know about these or just want an example code snippet of an event log topic filter to track mints, scroll down to the “Example Event Log Topic Filter” section!

What are subscription types?

The Alchemy Subscription API allows you to track different subscription types. For tracking Mint events, we will be using the log subscription type to listen to transfer events emitted by your smart contract that has the from address set to the zero address.

What are log topics?

Mosttransactions on Ethereum also emit Event Logs. Event Logs are comprised of two parts: (1) Topics, and (2) Data.

Topics describe the Event and are indexed and searchable.

Data also describe the Event but are not indexed nor searchable.

Here is an example of an NFT mint’s Event Log with Topics and Data shown on Etherscan:

Topic 0 (0xddf...) is the keccak256 hash of the Transfer event signature.

Topic 1 (0x000...) is the input to the first argument of the Transfer event, the zero address.

Topic 2 (0x7e67...) is the input to the second argument of the Transfer event, the recipient of the mint.

Topic 3 (8) is the input to the third argument of the Transfer event, the tokenId.

Example Event Log Topic Filter

Here is an example configuration for Event Log Topic to track NFT mints on the HackrDAO test contract on Goerli:

1
// This is the "transfer event" topic we want to watch.
2
const mintTopic = "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef";
3
// This is the "from address" we want to watch.
4
const zeroTopic = "0x0000000000000000000000000000000000000000000000000000000000000000";
5
// This is the NFT contract we want to watch.
6
const nftContractAddress = "0xbd34d145fcfd3992a0def1057891d51339a90128";
7
8
// Create the log options object.
9
const hackrDaoMintEvents = {
10
    address: nftContractAddress,
11
    topics: [mintTopic, zeroTopic]
12
}

5. Write the script and run it!

Using the Alchemy’s Subscription API, we can plug in all our config state and finish up the script.

1
import { createPublicClient, webSocket, parseAbiItem } from 'viem'
2
import { mainnet } from 'viem/chains'
3
4
const apiKey = "API_KEY"; // Replace with your Alchemy API Key.
5
6
// Create client with WebSocket transport
7
const publicClient = createPublicClient({
8
  chain: mainnet,
9
  transport: webSocket(`wss://eth-mainnet.g.alchemy.com/v2/${apiKey}`)
10
})
11
12
// This is the NFT contract we want to watch.
13
const nftContractAddress = "0xbd34d145fcfd3992a0def1057891d51339a90128";
14
15
// TODO: Add whatever logic you want to run upon mint events.
16
const doSomethingWithLogs = (logs) => {
17
  logs.forEach(log => {
18
    console.log('NFT Minted!', {
19
      contract: log.address,
20
      from: log.topics[1],
21
      to: log.topics[2],
22
      tokenId: log.topics[3],
23
      transactionHash: log.transactionHash
24
    });
25
  });
26
};
27
28
// Watch for Transfer events from zero address (mints)
29
const unwatch = publicClient.watchEvent({
30
  address: nftContractAddress,
31
  event: parseAbiItem('event Transfer(address indexed from, address indexed to, uint256 indexed tokenId)'),
32
  args: {
33
    from: '0x0000000000000000000000000000000000000000'
34
  },
35
  onLogs: doSomethingWithLogs
36
});
37
38
console.log('Listening for NFT mints...');

You can test your script by running the following command on your terminal locally:

node watch-for-mints.js

(replace watch-for-mints.js with the filename of your script)

Feel free to visit the verified contract code for the HackrDAO NFTs on Goerli and executing a mint call while running the above script. Once the mint transaction is mined, you should see an event logged to your console that looks like this:

$
{
>
  address: '0xBD34d145fcFD3992a0dEf1057891D51339a90128',
>
  topics: [
>
    '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef',
>
    '0x0000000000000000000000000000000000000000000000000000000000000000',
>
    '0x0000000000000000000000007e67af7ff72cb87b7b0100ca8128f4673d185234',
>
    '0x0000000000000000000000000000000000000000000000000000000000000008'
>
  ],
>
  data: '0x',
>
  blockNumber: 10374900,
>
  transactionHash: '0xa4a1fc5d099bf5963ba0af60cd4515b1491c5857bb92eed5d2b5551f68942cff',
>
  transactionIndex: 78,
>
  blockHash: '0xf0d0c9bdf41cd482ecd1a7ad396a62bc5f1828622cbe6f2d1076716ad1643e76',
>
  logIndex: 224,
>
  removed: false,
>
  id: 'log_ebf2ac1e'
>
}

That’s it!

Final thoughts and other APIs

We have a lot of other APIs that help you query for blockchain data easily. Check out these related APIs and services:

Transfers API

Notify API

Finally, if you’re a big tweeter, check out this guide in tweet form and reply to it if you have requests for any other guides you’d like us to write!

twitter.com

albert | thatguyintech.eth on Twitter: “How to TRACK NFT MINT EVENTS in REAL-TIME!Using @Alchemy’s Subscription API 👇🏼 pic.twitter.com/zlEXfenWgB / Twitter”

What mints are you tracking? 😛 Retweet me and share your alpha 😂.