Alchemy Login

NFT Metadata Updates Webhook

Get real-time updates when metadata for an NFT is updated

ChainMainnetTestnet
Ethereum:white-check-mark::white-check-mark:
Polygon:white-check-mark::white-check-mark:
Optimism:x::x:
Arbitrum:x::x:
Base:x::x:

Introduction

The NFT Metadata Updates webhook uses our patent pending metadata freshness technology to allow you to track metadata updates for ERC721 and ERC1155 token contracts on Ethereum and Polygon (Up to 3M contract/tokens per webhook!). This uses on chain and off chain indicators to notify your app when the NFT metadata is updated, such as during a reveal.

Example Response

When metadata for an NFT (ERC721 or ERC1155) is updated, you receive a response from the webhook that looks like this:

{
  "webhookId": "wh_yth2f9pn4kw69tav",
  "id": "whevt_wqaweymxxhiylx5a",
  "createdAt": "2023-09-18T18:08:13.472Z",
  "type": "NFT_METADATA_UPDATE",
  "event": {
    "network": "MATIC_MAINNET",
    "contractAddress": "0xb2435253c71fca27be41206eb2793e44e1df6b6d",
    "tokenId": "15489410",
    "networkId": 401,
    "metadataUri": "https://api.planetix.com/api/v1/pix/15489410",
    "updatedAt": "2023-09-18T18:08:12.349Z",
    "name": "GE LE#132100186",
    "imageUri": "https://static.planetix.com/46Sl0KZHaA856srXdxD9AnNC5SbzGvtCeqFZusuS.png",
    "attributes": [
      { "traitType": "NFT", "value": "PIX" },
      { "traitType": "ID", "value": "8c2c2aa9418b3ff" },
      {
        "traitType": "Coordinates",
        "value": "[41.67987855636909,44.78790872934742]"
      },
      { "traitType": "Classification", "value": "Capital City Center" },
      { "traitType": "Tier", "value": "Legendary" },
      { "traitType": "Country", "value": "GE" }
    ],
    "rawMetadata": {
      "name": "GE LE#132100186",
      "image": "https://static.planetix.com/46Sl0KZHaA856srXdxD9AnNC5SbzGvtCeqFZusuS.png",
      "attributes": [
        { "value": "PIX", "trait_type": "NFT" },
        { "value": "8c2c2aa9418b3ff", "trait_type": "ID" },
        {
          "value": "[41.67987855636909,44.78790872934742]",
          "trait_type": "Coordinates"
        },
        { "value": "Capital City Center", "trait_type": "Classification" },
        { "value": "Legendary", "trait_type": "Tier" },
        { "value": "GE", "trait_type": "Country" }
      ]
    }
  }
}

Field Definitions

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

FieldDescriptionValue
webhookIdUnique ID of the webhook destination.wh_9ov1pxcoll48hkew
idID of the event.whevt_0n4r4tqz9530yciz
createdAtTimestamp when the webhook was created.2022-10-31T21:20:25.031Z
typeWebhook event type.NFT_METADATA_UPDATE
eventNFT Metadata Updates object.N/A
contractAddressThe contract ID address.0x617913dd43dbdf4236b85ec7bdf9adfd7e35b340
tokenIdNFT's token ID.40060010
networkName of the networkMATIC_MAINNET
metadataUriThe URI pointing to the NFT's raw metadata.https://www.mycryptoheroes.net/metadata/landSector/40060010
updatedAtNFT's metadata update timestamp.2022-10-31T21:19:34.769Z
nameName of the NFT.MCH Land Sector: #40060010
descriptionNFT description."TRANSFERS FOR THIS ASSET ARE CURRENTLY DISABLED. To enable transfers for this asset, you need to set Art and Nickname inside the MCH World. Land Sectors are unique parts of Land in My Crypto Heroes.This Land Sector gives you partial ownership of FISHER ISLAND 🍇GRAPE🍇."
imageUriNFT media URI.https://www.mycryptoheroes.net/images/landsectorarts/2000/6_4.png
attributesA list of attributes for the NFT if they exist.N/A
rawMetadataThe updated metadata returned from the metadataUri field.N/A
imageURI of the NFT media.https://www.mycryptoheroes.net/images/landsectorarts/2000/6_4.png
external_urlURL ID of the NFT media.https://www.mycryptoheroes.net/landSectors/40060010
home_urlNFT homepage URL.https://www.mycryptoheroes.net
extra_dataList of NFT resources.N/A
default_image_urlThe default URL of the NFT media.https://www.mycryptoheroes.net/images/landsectorarts/64/6_4.png
nameNFT name.MCH Land Sector: #40060010
descriptionNFT description.TRANSFERS FOR THIS ASSET ARE CURRENTLY DISABLED. To enable transfers for this asset, you need to set Art and Nickname inside the MCH World. Land Sectors are unique parts of Land in My Crypto Heroes.This Land Sector gives you partial ownership of FISHER ISLAND 🍇GRAPE🍇.
languageNFT default language.en-US
attributesList of attributes for the NFT.N/A
volumeNFT volume.20
total_volumeNFT volume.900
type_nameNFT type identifier.Grape
transferNFT transfer status.disabled
rarityNFT character category.Epic
timestampNFT timestamp update.1667251174

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

Useful Endpoints

EndpointDescription
Update NFT Metadata Webhook FiltersAdd and remove NFT metadata webhook 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.
ReadMe