WebhooksWebhook Types

NFT Activity Webhook

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

Check the Chains page for details about product and chain support!

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:

NFT Activity Response
${
>  "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.

FieldDescriptionValue
webhookIdUnique ID of the webhook destination.wh_v394g727u681i5rj
idID of the event.whevt_13vxrot10y8omrdp
createdAtTimestamp when the webhook was created.2022-08-03T23:29:11.267808614Z
typeWebhook event type.NFT_ACTIVITY
eventNFT Activity object.N/A
activityList of transfer events whose from or to address matches the address configured in the NFT Activity webhook.N/A
networkThe default network for the webhook.ETH_GOERLI
fromAddressTransfer from address.0x2acc2dff0c1fa9c1c62f518c9415a0ca60e03f77
toAddressTransfer to address.0x15dd13f3c4c5279222b5f09ed1b9e9340ed17185
contractAddressThe contract ID address.0xf4910c763ed4e47a585e2d34baa9a4b611ae448c
blockNumberTransaction block number.0x78b94e
hashTransaction hash rate.0x6ca7fed3e3ca7a97e774b0eab7d8f46b7dcad5b8cf8ff28593a2ba00cdef4bff
erc1155MetadataList of objects containing the ERC1155 tokenId & value.N/A
tokenIdRaw erc721 token ID.0x2acc2dff0c1fa9c1c62f518c9415a0ca60e03f77000000000000010000000001
valueTransferred value amount.0x0
categoryThe ERC-721 or ERC-1155 data standard.erc1155
logReturned log of the token NFT Activity event.N/A
addressLog origination address.0xf4910c763ed4e47a585e2d34baa9a4b611ae448c
topicsArray of zero to four 32 bytes of indexed log arguments.0xc3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f62
dataNon-indexed arguments of the log.0x2acc2dff0c1fa9c1c62f518c9415a0ca60e03f7700000000000001000...
blockNumberTransaction block number.0x78b94e
transactionHashTransaction block number.0x6ca7fed3e3ca7a97e774b0eab7d8f46b7dcad5b8cf8ff28593a2ba00cdef4bff
transactionIndexThe index of the transaction location in the block.0x1b
blockHashThe ID hash of the block in the blockchain.0x4887f8bfbba48b7bff0362c34149d76783feae32f29bff3d98c841bc2ba1902f
logIndexID of the event.0x16
removedTransaction is in a [chain re-org] (https://www.alchemy.com/overviews/what-is-a-reorg) & no longer in the canonical chain.false
erc721TokenIdraw erc721 token id (hex string). null if not an erc721 token transfer.N/A

How to Set-Up NFT Activity Webhook

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

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

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

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

Useful Endpoints

EndpointDescription
Update Webhook NFT FiltersAdd and remove webhook NFT filters.
Webhook NFT FiltersPaginated endpoint to list all of the NFT filter objects a given webhook is subscribed to.
Create WebhookThis endpoint allows you to create a webhook programatically.
Delete WebhookAllows you to delete a webhook.
Update WebhookAllows you to set status of webhooks to active or inactive.