NFTYVERSE Docs
NFTYverse HomeRequest API Key
Search…
NFT APIs
Example Use Cases
Marketplaces
Metadata URIs
API Docs
Webhook Events
Blockchain Gas Fees
Powered By GitBook
Webhook Events
Receive notifications about completed blockchain transactions.
You can receive webhook events when NFT transfers and new NFT Tokens or Collections are completed on the blockchain. This is a great way to keep your UI responsive and up to date, though it is optional. Alternatively, you can also poll using the Requests API.
To enable webhook events, you need to create a URL endpoint on your app that can read and respond to these events. Then, just let us know your URL and we can help set it up for you. You will start receiving webhooks with the following data:

Event Types

sent - a blockchain transaction has been sent successfully

The request_id will match the one returned by the API call.
{
"type" : "sent",
"request_id" : "d27c2d343731f3b6894b1afa2d44c9f203d624cb0c99de1f3e00eb0a0ebe73bb",
"transaction_hash" : "0x5e14fa2b23dd36f28549d11d15589ba3a03b9b7773de234c4c5f19f1a2954327"
}

completed - a blockchain transaction completed successfully

The request_id will match the one returned by the API call. If this event is related to creating a new NFT token, then the nft_collection and nft_token_id are also returned
{
"type" : "completed",
"request_id" : "d27c2d343731f3b6894b1afa2d44c9f203d624cb0c99de1f3e00eb0a0ebe73bb",
"transaction_hash" : "0x5e14fa2b23dd36f28549d11d15589ba3a03b9b7773de234c4c5f19f1a2954327",
"nft_collection":"0x90de09166cd8ae30dc2bfe25be0f5bd486851cd7",
"nft_token_id":1
}

error - a blockchain transaction error occurred

The request_id will match the one returned by the API call.
{
"type" : "error",
"request_id" : "d27c2d343731f3b6894b1afa2d44c9f203d624cb0c99de1f3e00eb0a0ebe73bb",
"transaction_hash" : "0x5e14fa2b23dd36f28549d11d15589ba3a03b9b7773de234c4c5f19f1a2954327"
}
Previous
Requests
Next
Blockchain Gas Fees
Last modified 8mo ago
Copy link
On this page
Event Types