NFT Activity Webhook

Get real-time updates when an NFT is transferred from the NFT collections that you track using the NFT Activity webhook

Chain	Mainnet	Testnet
Ethereum	✅	✅
Polygon	✅	✅
Optimism	✅	✅
Arbitrum	✅	✅
Base	❌	❌
zkSync Era	✅	✅
Arbitrum Nova	✅	✅
BNB Smart Chain	✅	✅
Avalanche	✅	✅
Blast	✅	✅

Introduction

The NFT Activity webhook allows you to track ERC721 and ERC1155 token contracts for Ethereum, Arbitrum, Optimism and Polygon NFTs. This provides your app with real-time state changes when an NFT is transferred between addresses.

Example Response

When a token (ERC721 or ERC1155) from the token contracts that you are tracking gets transferred, you receive a response from the webhook that looks like this:

{
  "webhookId": "wh_5dzeea0ikdnzgq6w",
  "id": "whexs_awxsragnkmh182tl",
  "createdAt": "2024-05-31T21:38:13.912Z",
  "type": "NFT_ACTIVITY",
  "event": {
    "network": "ETH_MAINNET",
    "activity": [
      {
        "fromAddress": "0x715af6b6c6e3aefb97f1f6811ce52db563b38896",
        "toAddress": "0x29469395eaf6f95920e59f858042f0e28d98a20b",
        "contractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
        "blockNum": "0x1310fe1",
        "hash": "0xe6385e8896aa5de1147f8d324ebeb79640f7a0e6fc87f3685d5e39a531f14ea4",
        "erc721TokenId": "0x1eeb",
        "category": "erc721",
        "log": {
          "address": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            "0x000000000000000000000000715af6b6c6e3aefb97f1f6811ce52db563b38896",
            "0x00000000000000000000000029469395eaf6f95920e59f858042f0e28d98a20b",
            "0x0000000000000000000000000000000000000000000000000000000000001eeb"
          ],
          "data": "0x",
          "blockNumber": "0x1310fe1",
          "transactionHash": "0xe6385e8896aa5de1147f8d324ebeb79640f7a0e6fc87f3685d5e39a531f14ea4",
          "transactionIndex": "0x20",
          "blockHash": "0x50bf5446bee2aff19c2399250c93db840eaab0132e7750ed026acb92c93a92ec",
          "logIndex": "0x9c",
          "removed": false
        }
      }
    ]
  }
}

Field Definitions

Below you can find descriptions for each field of the response.

Field	Description	Value
`webhookId`	Unique ID of the webhook destination.	`wh_v394g727u681i5rj`
`id`	ID of the event.	`whevt_13vxrot10y8omrdp`
`createdAt`	Timestamp when the webhook was created.	`2022-08-03T23:29:11.267808614Z`
`type`	Webhook event type.	`NFT_ACTIVITY`
`event`	NFT Activity object.	`N/A`
`activity`	List of transfer events whose `from` or `to` address matches the address configured in the NFT Activity webhook.	`N/A`
`network`	The default network for the webhook.	`ETH_GOERLI`
`fromAddress`	Transfer from address.	`0x2acc2dff0c1fa9c1c62f518c9415a0ca60e03f77`
`toAddress`	Transfer to address.	`0x15dd13f3c4c5279222b5f09ed1b9e9340ed17185`
`contractAddress`	The contract ID address.	`0xf4910c763ed4e47a585e2d34baa9a4b611ae448c`
`blockNumber`	Transaction block number.	`0x78b94e`
`hash`	Transaction hash rate.	`0x6ca7fed3e3ca7a97e774b0eab7d8f46b7dcad5b8cf8ff28593a2ba00cdef4bff`
`erc1155Metadata`	List of objects containing the ERC1155 `tokenId` & `value`.	`N/A`
`tokenId`	Raw `erc721` token ID.	`0x2acc2dff0c1fa9c1c62f518c9415a0ca60e03f77000000000000010000000001`
`value`	Transferred value amount.	`0x0`
`category`	The `ERC-721` or `ERC-1155` data standard.	`erc1155`
`log`	Returned log of the `token` NFT Activity event.	`N/A`
`address`	Log origination address.	`0xf4910c763ed4e47a585e2d34baa9a4b611ae448c`
`topics`	Array of zero to four 32 bytes of indexed log arguments.	`0xc3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f62`
`data`	Non-indexed arguments of the log.	`0x2acc2dff0c1fa9c1c62f518c9415a0ca60e03f7700000000000001000...`
`blockNumber`	Transaction block number.	`0x78b94e`
`transactionHash`	Transaction block number.	`0x6ca7fed3e3ca7a97e774b0eab7d8f46b7dcad5b8cf8ff28593a2ba00cdef4bff`
`transactionIndex`	The index of the transaction location in the block.	`0x1b`
`blockHash`	The ID hash of the block in the blockchain.	`0x4887f8bfbba48b7bff0362c34149d76783feae32f29bff3d98c841bc2ba1902f`
`logIndex`	ID of the event.	`0x16`
`removed`	Transaction is in a [chain re-org] (https://www.alchemy.com/overviews/what-is-a-reorg) & no longer in the canonical chain.	`false`
`erc721TokenId`	raw erc721 token id (hex string). `null` if not an erc721 token transfer.	`N/A`

How to Set-Up NFT Activity Webhook

In your [Alchemy Dashboard] (https://dashboard.alchemyapi.io/notify) click the Notify tab.
Find NFT Activity and click the CREATE WEBHOOK button on the right side of the window.

Select your CHAIN in the dropdown. Then choose your NETWORK.
Paste your unique webhook URL into the WEBHOOK URL field.
Add your NFT ADDRESSES.
Enter your TOKEN IDS.

Test your webhook by clicking the TEST WEBHOOK button.
After the test is successful, click CREATE WEBHOOK. Your webhook appears in the list.
Check your endpoint to see the responses.

To add/remove addresses from already existing webhooks check out update webhook addresses endpoint.

Useful Endpoints

Endpoint	Description
Update Webhook NFT Filters	Add and remove webhook NFT filters.
Webhook NFT Filters	Paginated endpoint to list all of the NFT filter objects a given webhook is subscribed to.
Create Webhook	This endpoint allows you to create a webhook programatically.
Delete Webhook	Allows you to delete a webhook.
Update Webhook	Allows you to set status of webhooks to active or inactive.