Token Metadata

Overview

The NFT Kit Token Metadata Event webhook allows your application to receive real-time notifications whenever an NFT's metadata is updated within EQHub's NFT Kit. Each time metadata modification occurs, EQHub will send detailed transaction data to your configured webhook endpoint.

Webhook Payload Structure Example

{
  "app": "EQHub",
  "data": {
    "transaction_hash": "0xExampleTransactionHash",
    "token_id": "1",
    "token_uri": "https://example.com/your-token-uri",
    "timestamp": "2025-02-17T09:45:15.000Z"
  },
  "event_name": "NFT_KIT_TOKEN_METADATA",
  "service_identifier": "NFT_KIT",
  "resource_identifier": 1
}

Payload Field Descriptions

Field	Type	Description
`app`	String	Fixed value: "EQHub"
`data.transaction_hash`	String	Blockchain hash representing the metadata update
`data.token_id`	String	Unique identifier of the NFT whose metadata was updated
`data.token_uri`	String	URI pointing to the updated metadata
`data.timestamp`	String	ISO timestamp when metadata update occurred
`event_name`	String	Fixed value: "NFT_KIT_TOKEN_METADATA"
`service_identifier`	String	Fixed value: "NFT_KIT"
`resource_identifier`	Integer	Identifier for NFT Kit (`kit_id`)

How to Receive NFT Kit Token Metadata Events

To receive webhook notifications for NFT Kit Token Metadata updates, create a webhook in the EQ Hub Console, register the NFT_KIT_TOKEN_METADATA event, and configure your webhook URL within the same setup process.

Example:

{
  "useWebhook": true,
  "webhookUrl": "https://your-callback-url.com/webhook"
}