Overview
Each event is structured as an object with a type and a data sub-object that holds the transaction ID and other related information. Your endpoint must check the event type and parse each event's payload.
List of events & descriptions
| Category | Event Type | Description |
|---|---|---|
| Transactions |
transaction.created
|
Triggered when any new transaction is identified in the workspace. |
| Transactions |
transaction.status.updated
|
Triggered when there is any change in a transaction's status or when Fireblocks detects an update to the number of confirmations. |
| Transactions |
transaction.approval_status.updated
|
Triggered on every approval based on the transaction authorization policy. |
| Transactions |
transaction.network_records.processing_completed
|
Triggered when the processing of all the network records is completed. The transaction data contains all the transaction's network records. |
| Whitelist |
external_wallet.asset.added
|
Triggered when any asset is added to an external wallet. |
| Whitelist |
external_wallet.asset.removed
|
Triggered when any asset is removed from an external wallet. |
| Whitelist |
internal_wallet.asset.added
|
Triggered when any asset is added from an internal wallet. |
| Whitelist |
internal_wallet.asset.removed
|
Triggered when any asset is removed from an internal wallet. |
| Whitelist |
contract_wallet.asset.added
|
Triggered when any asset is added to a contract wallet. |
| Whitelist |
contract_wallet.asset.removed
|
Triggered when any asset is removed from a contract wallet. |
| Wallet |
vault_account.created
|
Triggered when a vault account is created. |
| Wallet |
vault_account.asset.added
|
Triggered when any asset is added to a vault account. |
| Wallet |
vault_account.asset.balance_updated
|
Triggered when a vault account's asset balance is updated. |
| Wallet |
vault_account.nft.balance_updated
|
Triggered when a vault account's NFT balance changes. |
| Embedded Wallets |
embedded_wallet.created
|
Triggered when a a wallet is created within an EW tenant. |
| Embedded Wallets |
embedded_wallet.status.updated
|
Triggered when a wallet status is updated within an EW tenant. |
| Embedded Wallets |
embedded_wallet.account.created
|
Triggered when an account is created in an embedded wallet. |
| Embedded Wallets |
embedded_wallet.asset.added
|
Triggered when an asset is added to an embedded wallet account. |
| Embedded Wallets |
embedded_wallet.asset.balance_updated
|
Triggered when an embedded wallet’s asset balance changes. |
| Embedded Wallets |
embedded_wallet.device.added
|
Triggered when a new device has requested to join a wallet |
| CeFi |
exchange_account.added
|
Triggered when any exchange account is added. |
| CeFi |
fiat_account.added
|
Triggered when any fiat account is added. |
| Network Connection |
network_connection.added
|
Triggered when any Fireblocks network connection is added. |
| Network Connection |
connection.removed
|
Triggered when a Fireblocks Network connection is removed. |
| Network Connection |
connection.request.waiting_peer_approval
|
Triggered when a Fireblocks Network connection request is approved by initiator. |
| Network Connection |
connection.request.rejected_by_peer
|
Triggered when a Fireblocks Network connection request is rejected. |
| Smart Transfer |
ticket.created
|
Triggered when a smart transfer ticket is created. |
| Smart Transfer |
ticket.submitted
|
Triggered when a smart transfer ticket is submitted. |
| Smart Transfer |
ticket.expired
|
Triggered when a smart transfer ticket expires. |
| Smart Transfer |
ticket.canceled
|
Triggered when a smart transfer ticket is canceled. |
| Smart Transfer |
ticket.fulfilled
|
Triggered when a smart transfer ticket is funded. |
| Smart Transfer |
ticket.counterparty.added
|
Triggered when a counterparty is added to a smart transfer ticket. |
| Smart Transfer |
ticket.term.added
|
Triggered when a Smart Transfer ticket term is added. |
| Smart Transfer |
ticket.term.updated
|
Triggered when a Smart Transfer ticket term is updated. |
| Smart Transfer |
ticket.term.deleted
|
Triggered when a Smart Transfer ticket term is deleted. |
| Smart Transfer |
ticket.term.deleted
|
Triggered when a Smart Transfer ticket term is deleted. |
| Smart Transfer |
ticket.term.funded
|
Triggered when a Smart Transfer ticket term is funded. |
| Smart Transfer |
ticket.term.manually_funded
|
Triggered when a Smart Transfer ticket term is manually funded. |
| Smart Transfer |
ticket.term.funding_failed
|
Triggered when a Smart Transfer ticket term’s funding fails. |
| Smart Transfer |
ticket.term.funding_canceled
|
Triggered when a Smart Transfer ticket term’s funding is canceled. |
| Smart Transfer |
ticket.term.funding_failed
|
Triggered when a Smart Transfer ticket term’s funding fails. |
| Smart Transfer |
ticket.term.funding_completed
|
Triggered when a Smart Transfer ticket term funding is funded. |
| Smart Transfer |
ticket.term.transaction_status_changed
|
Triggered when a Smart Transfer ticket term’s status changes. |
| Off Exchange |
settlement.created
|
A notification is sent when a new settlement is initiated in the workspace. |
| Off Exchange |
collateral.status.updated
|
A notification is sent to the exchange once a collateral user is created and has a pairing token available. |
| On-chain Data |
onchain_data.updated
|
Triggered when Fireblocks enriches a blockchain transaction with decoded on-chain data and logs. |