Webhook event types
Here, transaction refers to all types of transactions, including deposits, withdrawals, contract calls, and message signing.
Payment events
For payment webhook events, please refer to Order Status and Events.
Transaction events (deposits/withdrawals/contract calls/message signing)
The following events apply to all types of transactions, including deposits, withdrawals, contract calls, and message signing.
| Event Type | Event Data Type | When It Occurs |
|---|
wallets.transaction.created | Transaction | A transaction has been detected on the blockchain, generating a transaction record. This event does not indicate that the transaction was successful. |
wallets.transaction.updated | Transaction | There are changes to a transaction’s status or confirmation numbers.The wallets.transaction.updated event covers the entire lifecycle of a transaction, including creation, completion, and failure. If you want to track every status change, you need only subscribe to this event. |
wallets.transaction.succeeded | Transaction | A transaction has been successfully completed. |
wallets.transaction.failed | Transaction | A transaction failed. |
token.suspended.deposit | SuspendedToken | A token deposit has been suspended. |
token.suspended.withdraw | SuspendedToken | A token withdrawal has been suspended. |
Fee Station events
| Event Type | Event Data Type | When It Occurs |
|---|
fee_station.transaction.created | Transaction | A Fee Station transaction has been created. |
fee_station.transaction.updated | Transaction | There are changes to the status of a Fee Station transaction. |
fee_station.transaction.failed | Transaction | A Fee Station transaction failed. |
fee_station.transaction.succeeded | Transaction | A Fee Station transaction has been successfully completed. |
MPC TSS request events
| Event Type | Event Data Type | When It Occurs |
|---|
wallets.mpc.tss_request.created | TSSRequest | A TSS request is created. |
wallets.mpc.tss_request.updated | TSSRequest | There are changes to the status of a TSS request. |
wallets.mpc.tss_request.succeeded | TSSRequest | The requested action has been successfully completed. |
wallets.mpc.tss_request.failed | TSSRequest | The requested action failed. |
Wallet and address management events
| Event Type | Event Data Type | When It Occurs |
|---|
wallets.addresses.created | Addresses | A new wallet address has been created. |
wallets.created | WalletInfo | A new wallet has been created. |
mpc_vaults.created | MPCVault | A new MPC vault has been created. |
Token and chain management events
| Event Type | Event Data Type | When It Occurs |
|---|
wallet.token.enabled | Tokens | One or more tokens have been enabled. |
wallet.token.disabled | Tokens | One or more tokens have been disabled. |
wallet.chain.enabled | Chains | One or more chains have been enabled. |
wallet.chain.disabled | Chains | One or more chains have been disabled. |
wallets.token_listing.failed | TokenListing | A token listing request failed. |
wallets.token_listing.succeeded | TokenListing | A token listing request has been successfully processed and the token is now available. |
Balance update events
| Event Type | Event Data Type | When It Occurs |
|---|
wallet.mpc.balance.updated | BalanceUpdateInfo | The balance of an MPC Wallet has been updated. |
wallet.web3.balance.updated | BalanceUpdateInfo | The balance of a Custodial Wallet (Web3 Wallet) has been updated. |
Data structure of webhook events
For a complete introduction of the webhook event data and its data structure, refer to the data property in the response of the Retrieve event information operation or the data.data property in the response of the List all webhook event operation.
Switch between the event data types to view the data structure of each event data type.
Additionally, you can view all webhook events in your organization on Cobo Portal > Developer> Webhook Events.
