Webhook Events: Activities
The activities webhook event provides details on minting (NFT), transferring (NFT), burning (NFT), trading (NFT), withdrawals (ERC20) and deposits (ERC20) on Immutable's zkEVM blockchain. These events are great for tracking NFT ownership changes, as well as monitoring blockchain activity to trigger updates to your application.
What information does the activities webhook event provide?
Activities are enriched blockchain events provided by Immutable to developers. These events detail various on-chain activities, each categorized by an activityType
. They are particularly useful for tracking asset ownership changes, as ownership details are included in events like imtbl_zkevm_activity_burn
, imtbl_zkevm_activity_transfer
, and imtbl_zkevm_activity_sale
.
No NFT metadata is provided in the Activities events; the following workflows are available to determine an asset's metadata:
- Backend Integration: Use your local application's backend to keep track of metadata attributes and
token_id
tometadata_id
mappings. These can be found by subscribing to NFT and Metadata events. - API Polling: Use the Blockchain Data API NFT endpoint using
token_id
to review the assets metadata attributes.
By doing so, developers can efficiently track asset ownership changes while also obtaining metadata details when needed.
The following activityTypes
are supported:
Activity Type | Activities Event | Description |
---|---|---|
mint | imtbl_zkevm_activity_mint | An activity of type mint means an NFT has been created and recorded onto a blockchain as a unique and indivisible digital asset, representing digital art, music, videos, or other creative works. |
burn | imtbl_zkevm_activity_burn | An activity of type burn identifies an NFT that has been intentionally and permanently destroyed, usually by sending it to an unspendable address (0x0000000000000000000000000000000000000000 ). |
transfer | imtbl_zkevm_activity_transfer | An activity of type transfer means an NFT has been sent from one person's digital wallet address to another person's digital wallet address, resulting in a change of ownership on the blockchain. |
sale | imtbl_zkevm_activity_sale | An activity of type sale means an NFT has been exchanged for a certain amount of cryptocurrency or fiat currency between a buyer and a seller on an online marketplace. |
deposit | imtbl_zkevm_activity_deposit | An activity of type deposit means an ERC20 token has been deposited from the Ethereum blockchain |
withdrawal | imtbl_zkevm_activity_withdrawal | An activity of type withdrawal means an ERC20 token has been withdrawn to the Ethereum blockchain |
Example responses
Below are some examples of activities events for each activityTypes
:
- Mint
- Burn
- Transfer
- Sale
- Deposit
- Withdrawal
{
"Type": "Notification",
"MessageId": "dca9d68e-f9b0-5b4b-aca7-8b26df34eac6",
"TopicArn": "arn:aws:sns:us-east-2:783421985614:webhook-outbound-sandbox",
"Message": "{"event_name":"imtbl_zkevm_activity_mint","event_id":"018b3c3d-a3aa-a4c9-4c16-dc7a2bd7d715","chain":"imtbl-zkevm-testnet","data":{"id":"018b3c3d-a377-8e68-6cab-2e8db249729a","chain":{"id":"eip155:13473","name":"imtbl-zkevm-testnet"},"details":{"to":"0x9c1634bebc88653d2aebf4c14a3031f62092b1d9","asset":{"token_id":"123123","contract_type":"erc721","contract_address":"0x43c98025464e9b326be3c3782db5867073b8e78c"},"amount":"1"},"indexed_at":"2023-10-17 06:05:54.469511","activity_type":"mint","blockchain_metadata":{"log_index":"0","block_number":"2895332","transaction_hash":"0xa58996d4250b964799ad62afa1b6d9188df1d60fad339857ccab4388a07212af","transaction_index":"0"}}}",
"Timestamp": "2023-10-17T06:05:56.378Z",
"SignatureVersion": "1",
"Signature": "hYHM9z0H38JA3AYO/guKTRgsxloGLx0vICVLny36gM8vfqjj1i7xzxRioWFTB+OfngE96gG+vmLmGf7W/RWkjf+dn9dKBijAtZ5CTKigkYnhmxNY1CuarAsEAzf2BlpY80fzHx+gaHaLUgaC6/DJ3ZGD1gM8SS4J5JWKWpvf7DAclGyIp8cPHCcsOcT8JBJf1Mu8Z+0sDOIhtsMD04pUn6QGAbZ82z6eG9mn1PbrocPE/8lOk8elmXdvQjVn9+FcLEIEadXG6INooJ5e5EtZuVEKXlVj9tPugwDbm/1nuWWAf2tArjGvHzIWL04IwbBMDj5Bx5cMU7ycPuLoea3ATA==",
"SigningCertURL": "https://sns.us-east-2.amazonaws.com/SimpleNotificationService-01d088a6f77103d0fe307c0069e40ed6.pem",
"UnsubscribeURL": "https://sns.us-east-2.amazonaws.com/?Action=Unsubscribe&SubscriptionArn=arn:aws:sns:us-east-2:783421985614:webhook-outbound-sandbox:b2be3be8-98de-4d84-b9b1-98d95859351d",
"MessageAttributes": {
"chain": {
"Type": "String",
"Value": "imtbl-zkevm-testnet"
},
"collection_address": {
"Type": "String",
"Value": "0x43c98025464e9b326be3c3782db5867073b8e78c"
},
"event": {
"Type": "String",
"Value": "imtbl_zkevm_activity_mint"
}
}}
{
"Type": "Notification",
"MessageId": "0f07c54b-6012-511f-bcfc-98e346e2ae54",
"TopicArn": "arn:aws:sns:us-east-2:783421985614:webhook-outbound-sandbox",
"Message": "{"event_name":"imtbl_zkevm_activity_burn","event_id":"018b3c3f-4f8e-6432-7777-d5ebb3cfcbf8","chain":"imtbl-zkevm-testnet","data":{"id":"018b3c3f-4f68-2cf0-294d-de745ac3c83e","chain":{"id":"eip155:13473","name":"imtbl-zkevm-testnet"},"details":{"from":"0x9c1634bebc88653d2aebf4c14a3031f62092b1d9","asset":{"token_id":"123123","contract_type":"erc721","contract_address":"0x43c98025464e9b326be3c3782db5867073b8e78c"},"amount":"1"},"indexed_at":"2023-10-17 06:07:43.976969","activity_type":"burn","blockchain_metadata":{"log_index":"0","block_number":"2895386","transaction_hash":"0x8ae7f0741df92ae9ed2cccb2947159cae0e1c14da14f9ae94aa3221de237db3b","transaction_index":"0"}}}",
"Timestamp": "2023-10-17T06:07:44.425Z",
"SignatureVersion": "1",
"Signature": "qjvZcBDXIybQUVIkOGeiXu62C3Wk7e5RcLtV3K8GeToXDOI7rCq0D0BBp4PATmnengdQ+/9IEll94+iAXdHgdczmd6F5+Y45ejh1u2S4T7j5dyaxzjZMr6kd1ULH3m2+WFqim14jeyPXClIHUMTfqtQxQuNemIy4pYnfnsy/j8JcR46aGcGWe2aIcytc0EqAE4CBnrG6iUwAFqOyVZF5S/9lWARacCm/JDU1mP3JqCBnqzFu8XwGaOAhXafgJAQmVvUo9gsoKV/+EvT8AIeLv0B8QbDtpR13IStdWIzJzYYD/OiExPquDlcQAbVfWBcMe2bcGD77QDeOky3ZAeWWnA==",
"SigningCertURL": "https://sns.us-east-2.amazonaws.com/SimpleNotificationService-01d088a6f77103d0fe307c0069e40ed6.pem",
"UnsubscribeURL": "https://sns.us-east-2.amazonaws.com/?Action=Unsubscribe&SubscriptionArn=arn:aws:sns:us-east-2:783421985614:webhook-outbound-sandbox:b2be3be8-98de-4d84-b9b1-98d95859351d",
"MessageAttributes": {
"chain": {
"Type": "String",
"Value": "imtbl-zkevm-testnet"
},
"collection_address": {
"Type": "String",
"Value": "0x43c98025464e9b326be3c3782db5867073b8e78c"
},
"event": {
"Type": "String",
"Value": "imtbl_zkevm_activity_burn"
}
}}
{
"Type": "Notification",
"MessageId": "55a0d5cd-56e3-5075-b11a-8865634a8d5d",
"TopicArn": "arn:aws:sns:us-east-2:783421985614:webhook-outbound-sandbox",
"Message": "{"event_name":"imtbl_zkevm_activity_transfer","event_id":"018b3c78-d474-e207-6b19-4c12913db24a","chain":"imtbl-zkevm-testnet","data":{"id":"018b3c78-d466-ec11-5141-d8f0df508b04","chain":{"id":"eip155:13473","name":"imtbl-zkevm-testnet"},"details":{"to":"0x452e19c31112972fcb28f0b064f008d7206dc5e0","from":"0xc606830d8341bc9f5f5dd7615e9313d2655b505d","asset":{"token_id":"1","contract_type":"erc721","contract_address":"0x202662966b8668f59438db640edc3e8f730d4723"},"amount":"1"},"indexed_at":"2023-10-17 07:10:33.575293","activity_type":"transfer","blockchain_metadata":{"log_index":"3","block_number":"2897247","transaction_hash":"0xc2073dedbdc307777d871b1ea8ffcdf1944ef2e352cbcbe6bce6e7adef7f9146","transaction_index":"0"}}}",
"Timestamp": "2023-10-17T07:10:33.800Z",
"SignatureVersion": "1",
"Signature": "X+YiHeGur1hqxAMY8/vtURj1rUUvRRIdsLSh1O3N0PjVNznWRkOOmf8SXgeb87XAS5L9NWjFpw+r69Rfd2cIBajXHSeA7WUQyOqVUcXrYfF2IX6kQ3isrX7YHbVgg5I0ADRr7ujG4QlEaYObEPZNbgOsB4lsB5Azc6SO1C+pK9VZVQZ+WzYP94z9RRYRX8Hp9Kfe+SHzUZGYuMVCO1cvMTIuiI/wolFSm35Gy75T4OlTRHx+BCIorifGMS/tqZF9HWdsy0TyBhtBgkDxIF2wAN7lGZIRPyHeZWvgUX69KJBDZskj6X4xXL8M0ChtQ8npk3avMU5ELPn97X8zN5/SJQ==",
"SigningCertURL": "https://sns.us-east-2.amazonaws.com/SimpleNotificationService-01d088a6f77103d0fe307c0069e40ed6.pem",
"UnsubscribeURL": "https://sns.us-east-2.amazonaws.com/?Action=Unsubscribe&SubscriptionArn=arn:aws:sns:us-east-2:783421985614:webhook-outbound-sandbox:b2be3be8-98de-4d84-b9b1-98d95859351d",
"MessageAttributes": {
"chain": {
"Type": "String",
"Value": "imtbl-zkevm-testnet"
},
"collection_address": {
"Type": "String",
"Value": "0x202662966b8668f59438db640edc3e8f730d4723"
},
"event": {
"Type": "String",
"Value": "imtbl_zkevm_activity_transfer"
}
}
}
{
"Type": "Notification",
"MessageId": "5ce3ddd1-a77b-52e2-94e0-807992d7b22c",
"TopicArn": "arn:aws:sns:us-east-2:783421985614:webhook-outbound-sandbox",
"Message": "{"event_name":"imtbl_zkevm_activity_sale","event_id":"018b3c78-ddd6-3d41-09e0-04d5f272ef72","chain":"imtbl-zkevm-testnet","data":{"id":"018b3c78-ddaa-aa9d-27ae-4bdca220e62e","chain":{"id":"eip155:13473","name":"imtbl-zkevm-testnet"},"details":{"to":"0x452e19c31112972fcb28f0b064f008d7206dc5e0","from":"0xc606830d8341bc9f5f5dd7615e9313d2655b505d","asset":[{"amount":"1","token_id":"0","contract_type":"erc721","contract_address":"0x202662966b8668f59438dB640eDC3e8F730D4723"}],"payment":{"fees":[{"amount":"1000","fee_type":"ROYALTY","recipient":"0xc606830d8341bc9f5f5dd7615e9313d2655b505d"},{"amount":"2000","fee_type":"PROTOCOL","recipient":"0xc606830d8341bc9f5f5dd7615e9313d2655b505d"},{"amount":"1","fee_type":"MAKER_ECOSYSTEM","recipient":"0xc606830d8341bc9f5f5dd7615e9313d2655b505d"},{"amount":"1","fee_type":"TAKER_ECOSYSTEM","recipient":"0xc606830d8341bc9f5f5dd7615e9313d2655b505d"}],"token":{"symbol":"IMX","contract_type":"","contract_address":""},"price_excluding_fees":"100000","price_including_fees":"103002"},"order_id":"018b3c78-975e-fc06-f225-6b00a151f6dc"},"indexed_at":"2023-10-17 07:10:35.977219","activity_type":"sale","blockchain_metadata":{"log_index":"0","block_number":"2897247","transaction_hash":"0xc2073dedbdc307777d871b1ea8ffcdf1944ef2e352cbcbe6bce6e7adef7f9146","transaction_index":"0"}}}",
"Timestamp": "2023-10-17T07:10:36.292Z",
"SignatureVersion": "1",
"Signature": "Pnb4KFwAsTwXTlOSW7pbsGsIhlgZ1HwqCquvRvsFK5a2hLgOeIM7GmSbnJ8mpWxKXa3Se/ukgVTJkFZIMSw2iIToS8eLZs/YlLbW/FOsoPHYKeyEWtsD9dO8aWPh0pgwsJhk8wSuoXftxqxj6XfWulza5qwIDpsMGFvSqGsw5oEGYejCxdbHpOU9IfGT7h85no71oa+jK/66IPoh0fUGahP4scEmyO3NNI4WB+fBw6ODrTjUEmPwRRT3vG96vK2KPSADH/4ftliz20TdxU7cWMSXGLgImoccjTGT2tKNZvuuSK2cKaejcC2hRwD0s9tFkCXuKWRthS66nxdik2WtNQ==",
"SigningCertURL": "https://sns.us-east-2.amazonaws.com/SimpleNotificationService-01d088a6f77103d0fe307c0069e40ed6.pem",
"UnsubscribeURL": "https://sns.us-east-2.amazonaws.com/?Action=Unsubscribe&SubscriptionArn=arn:aws:sns:us-east-2:783421985614:webhook-outbound-sandbox:b2be3be8-98de-4d84-b9b1-98d95859351d",
"MessageAttributes": {
"chain": {
"Type": "String",
"Value": "imtbl-zkevm-testnet"
},
"collection_address": {
"Type": "String",
"Value": "0x202662966b8668f59438dB640eDC3e8F730D4723"
},
"event": {
"Type": "String",
"Value": "imtbl_zkevm_activity_sale"
}
}}
{
"Type": "Notification",
"MessageId": "5ce3ddd1-a77b-52e2-94e0-807992d7b22c",
"TopicArn": "arn:aws:sns:us-east-2:783421985614:webhook-outbound-sandbox",
"Message": "{"event_name":"imtbl_zkevm_activity_deposit","event_id":"018b3c78-ddd6-3d41-09e0-04d5f272ef72","chain":"imtbl-zkevm-testnet","data":{"blockchain_metadata":{"block_number":"2630932","log_index":"0","transaction_hash":"0xee59abe924e1dffde3c87cbd67d49b8f3a11820d6fffdc6c1d1af253de4a2284","transaction_index":"0"},"chain":{"id":"eip155:13473","name":"imtbl-zkevm-testnet"},"details":{"amount":"10000000000000000","asset":{"contract_type":"erc20","contract_address":"0x65aa7a21b0f3ce9b478aac3408fe75b423939b1f"},"to":"0x18ea1d312a4037b8676c760abfd7d1dbe65486a1"},"id":"018b1c3c-be6e-22bd-ecc2-13a140a740d5","indexed_at":"2023-10-11T00:57:04.878621Z","activity_type":"deposit"}}",
"Timestamp": "2023-10-17T07:10:36.292Z",
"SignatureVersion": "1",
"Signature": "Pnb4KFwAsTwXTlOSW7pbsGsIhlgZ1HwqCquvRvsFK5a2hLgOeIM7GmSbnJ8mpWxKXa3Se/ukgVTJkFZIMSw2iIToS8eLZs/YlLbW/FOsoPHYKeyEWtsD9dO8aWPh0pgwsJhk8wSuoXftxqxj6XfWulza5qwIDpsMGFvSqGsw5oEGYejCxdbHpOU9IfGT7h85no71oa+jK/66IPoh0fUGahP4scEmyO3NNI4WB+fBw6ODrTjUEmPwRRT3vG96vK2KPSADH/4ftliz20TdxU7cWMSXGLgImoccjTGT2tKNZvuuSK2cKaejcC2hRwD0s9tFkCXuKWRthS66nxdik2WtNQ==",
"SigningCertURL": "https://sns.us-east-2.amazonaws.com/SimpleNotificationService-01d088a6f77103d0fe307c0069e40ed6.pem",
"UnsubscribeURL": "https://sns.us-east-2.amazonaws.com/?Action=Unsubscribe&SubscriptionArn=arn:aws:sns:us-east-2:783421985614:webhook-outbound-sandbox:b2be3be8-98de-4d84-b9b1-98d95859351d",
"MessageAttributes": {
"chain": {
"Type": "String",
"Value": "imtbl-zkevm-testnet"
},
"collection_address": {
"Type": "String",
"Value": "0x202662966b8668f59438dB640eDC3e8F730D4723"
},
"event": {
"Type": "String",
"Value": "imtbl_zkevm_activity_deposit"
}
}}
{
"Type": "Notification",
"MessageId": "5ce3ddd1-a77b-52e2-94e0-807992d7b22c",
"TopicArn": "arn:aws:sns:us-east-2:783421985614:webhook-outbound-sandbox",
"Message": "{"event_name":"imtbl_zkevm_activity_withdrawal","event_id":"018b3c78-ddd6-3d41-09e0-04d5f272ef72","chain":"imtbl-zkevm-testnet","data":{"blockchain_metadata":{"block_number":"9868","log_index":"0","transaction_hash":"0x72c36ea615f501098a73a9e92305ae41cb9f5b9c7bead8b6044860e4a8228397","transaction_index":"0"},"chain":{"id":"eip155:13473","name":"imtbl-zkevm-testnet"},"details":{"amount":"2500000000000000","asset":{"contract_type":"erc20","contract_address":"0x65aa7a21b0f3ce9b478aac3408fe75b423939b1f"},"from":"0x3095171469a0db24d9fb9c789d62df22bbafa816"},"id":"0189de04-2b80-b2ea-d967-0af6d0d143cc","indexed_at":"2023-08-10T05:56:02.560872Z","activity_type":"withdrawal"}}",
"Timestamp": "2023-10-17T07:10:36.292Z",
"SignatureVersion": "1",
"Signature": "Pnb4KFwAsTwXTlOSW7pbsGsIhlgZ1HwqCquvRvsFK5a2hLgOeIM7GmSbnJ8mpWxKXa3Se/ukgVTJkFZIMSw2iIToS8eLZs/YlLbW/FOsoPHYKeyEWtsD9dO8aWPh0pgwsJhk8wSuoXftxqxj6XfWulza5qwIDpsMGFvSqGsw5oEGYejCxdbHpOU9IfGT7h85no71oa+jK/66IPoh0fUGahP4scEmyO3NNI4WB+fBw6ODrTjUEmPwRRT3vG96vK2KPSADH/4ftliz20TdxU7cWMSXGLgImoccjTGT2tKNZvuuSK2cKaejcC2hRwD0s9tFkCXuKWRthS66nxdik2WtNQ==",
"SigningCertURL": "https://sns.us-east-2.amazonaws.com/SimpleNotificationService-01d088a6f77103d0fe307c0069e40ed6.pem",
"UnsubscribeURL": "https://sns.us-east-2.amazonaws.com/?Action=Unsubscribe&SubscriptionArn=arn:aws:sns:us-east-2:783421985614:webhook-outbound-sandbox:b2be3be8-98de-4d84-b9b1-98d95859351d",
"MessageAttributes": {
"chain": {
"Type": "String",
"Value": "imtbl-zkevm-testnet"
},
"collection_address": {
"Type": "String",
"Value": "0x202662966b8668f59438dB640eDC3e8F730D4723"
},
"event": {
"Type": "String",
"Value": "imtbl_zkevm_activity_withdrawal"
}
}}