Skip to main content
即刻安装 Cobo WaaS Skill,在 Claude Code、Cursor 等 AI 开发环境中使用自然语言集成 WaaS API,显著提升开发效率 🚀

Webhook 事件类型

可用的 webhook 事件类型如下:
本文所指交易为所有类型的交易,包括转账,合约调用和消息签名。

支付相关事件

支付相关的 Webhook 事件,请参考事件与状态

交易类事件(充币/提币/合约调用/消息签名)

以下事件适用于所有类型的交易,包括充币、提币、合约调用以及消息签名等。
事件类型事件数据类型发生时机
wallets.transaction.createdTransaction在区块链上检测到交易并生成记录。此事件不代表交易已成功。
wallets.transaction.updatedTransaction交易的状态或确认数发生变化。
wallets.transaction.updated 涵盖交易的整个生命周期,包括创建、完成和失败。如果您想跟踪每个状态变化,订阅此事件即可。
wallets.transaction.succeededTransaction交易已成功完成。
wallets.transaction.failedTransaction交易失败。
token.suspended.depositSuspendedToken充币已暂停。
token.suspended.withdrawSuspendedToken提币已暂停。

Fee Station 相关事件

事件类型事件数据类型发生时机
fee_station.transaction.createdTransactionFee Station 交易已创建。
fee_station.transaction.updatedTransactionFee Station 交易的状态发生变化。
fee_station.transaction.failedTransactionFee Station 交易失败。
fee_station.transaction.succeededTransactionFee Station 交易已完成。

MPC 钱包 TSS 请求事件

事件类型事件数据类型发生时机
wallets.mpc.tss_request.createdTSSRequest创建了 TSS 请求。
wallets.mpc.tss_request.updatedTSSRequestTSS 请求的状态发生变化。
wallets.mpc.tss_request.succeededTSSRequest请求的操作已完成。
wallets.mpc.tss_request.failedTSSRequest请求的操作失败。

钱包与地址管理事件

事件类型事件数据类型发生时机
wallets.addresses.createdAddresses已创建新的钱包地址。
wallets.createdWalletInfo已创建新的钱包。
mpc_vaults.createdMPCVault已创建新的 MPC Vault。

代币与链管理事件

事件类型事件数据类型发生时机
wallet.token.enabledTokens一种或多种代币已被启用。
wallet.token.disabledTokens一种或多种代币已被禁用。
wallet.chain.enabledChains一条或多条链已被启用。
wallet.chain.disabledChains一条或多条链已被禁用。
wallets.token_listing.failedTokenListing上币请求失败。
wallets.token_listing.succeededTokenListing上币请求已成功处理,代币当前已可用。

余额更新事件

事件类型事件数据类型发生时机
wallet.mpc.balance.updatedBalanceUpdateInfoMPC 钱包余额更新。
wallet.web3.balance.updatedBalanceUpdateInfo全托管钱包(Web3 钱包)余额更新。

合规事件

事件类型事件数据类型发生时机
compliance.disposition.status.updatedComplianceDisposition合规处置的状态发生变化。
compliance.kyt.screenings.status.updatedComplianceKytScreeningsKYT 扫描的状态发生变化。

Webhook 事件数据结构

有关 webhook 事件数据和其数据结构的完整介绍,请参阅 Retrieve event information 操作的响应中的 data 属性或 List all webhook events 操作的响应中的 data.data 属性。 Webhook 数据结构截图 您可以在事件数据类型之间切换来查看每个事件数据类型的数据结构。 另外,您可以在 Cobo Portal > 开发者 > Webhook 事件 中查看团队中的所有 webhook 事件。