Webhooks

Breeze sends a webhook every time a Liquidation Address Transaction changes status, so you can track each deposit from confirmation through settlement without polling.

Configuring webhooks

For webook configuration and validation, please refer to this doc

The transaction status event

A LIQUIDATION_ADDRESS_TRANSACTION_STATUS_UPDATE event is sent whenever a transaction's status changes (for example, from TRADE_PENDING to SETTLEMENT_PENDING).

Payload

{
  "type": "LIQUIDATION_ADDRESS_TRANSACTION_STATUS_UPDATE",
  "data": {
    "id": "liqtx_...",
    "liquidationAddressId": "liqaddr_...",
    "livemode": true,
    "status": "COMPLETED",
    "depositTransactionHash": "0x...",
    "depositAmount": "100.0",
    "depositCurrency": "USDC",
    "depositNetwork": "ETHEREUM",
    "depositConfirmedAt": 1748880000000,
    "fromAddress": "0x...",
    "settlementAmount": "99.5",
    "settlementCurrency": "USDC",
    "settlementNetwork": "SOLANA",
    "settlementAddress": "...",
    "settlementTransactionHash": "...",
    "settlementConfirmedAt": 1748880100000
  },
  "signature": "BASE64_HMAC_SHA256"
}

Field	Description
`id`	Liquidation Address Transaction ID.
`liquidationAddressId`	The address that received the deposit.
`livemode`	`true` for live mode, `false` for test mode.
`status`	Current lifecycle status (see Core Concepts).
`depositTransactionHash`	On-chain hash of the incoming deposit.
`depositAmount` / `depositCurrency` / `depositNetwork`	The deposit's amount, currency, and source network.
`depositConfirmedAt`	Unix milliseconds (UTC) when the deposit was confirmed.
`fromAddress`	Sender address. Empty for Solana deposits, where it cannot be parsed.
`settlementAmount` / `settlementCurrency` / `settlementNetwork`	The settled amount, currency, and destination network. Present once settlement details are known.
`settlementAddress`	The destination address funds were settled to.
`settlementTransactionHash`	On-chain hash of the settlement transfer. Present once settled.
`settlementConfirmedAt`	Unix milliseconds (UTC) when settlement was confirmed.