Core Concept

This page explains the building blocks of Liquidation Addresses: the address itself, how source and destination are defined, the lifecycle of a deposit, and which networks are supported.

The Liquidation Address

A Liquidation Address is a persistent, non-custodial on-chain address provisioned by Breeze. Once created, it stays valid indefinitely and can receive an unlimited number of deposits. Every deposit it receives is automatically converted to your destination currency and forwarded to your destination address.

An address has two halves: a source (what it accepts) and a destination (where settled funds go).

Source

The source defines what the address accepts.

Field	Description
`chain`	The network the address accepts deposits on. Use a specific network (e.g. `ETHEREUM`), or `EVM` to accept deposits on any supported EVM network.
`currency`	Optional. Restricts the address to a single deposit currency. If omitted, the address accepts any supported currency on the source network.

Destination

The destination defines where converted funds are settled.

Field	Description
`destinationChain`	The network funds are settled on.
`destinationCurrency`	The currency funds are converted into before settlement.
`destinationAddress`	The on-chain address that receives settled funds.

📘
Crypto-to-crypto only
Both source and destination are currently crypto. When the source and destination currency are identical, conversion is skipped and the deposit is settled directly.

Labels

An optional label (up to 256 characters) helps you identify an address in your own systems. It has no effect on processing.

The Liquidation Address Transaction

Each deposit creates a Liquidation Address Transaction — the record you track from arrival through settlement. It captures both the deposit and the resulting settlement:

Group	Fields
Deposit	transaction hash, amount, currency, network, confirmation time, sender address
Settlement	amount, currency, network, destination address, transaction hash, confirmation time
Status	the current lifecycle stage (see below)

Transaction lifecycle

A transaction moves through a sequence of statuses as Breeze confirms the deposit, converts it, and settles the proceeds.

flowchart LR
    A[DEPOSIT_CONFIRMED] --> B[TRADE_PENDING]
    B --> C[TRADE_EXECUTING]
    C --> D[SETTLEMENT_PENDING]
    D --> E[COMPLETED]
    A -. same currency .-> D

Status	Meaning
`PENDING_DEPOSIT_VALIDATION`	A deposit has been seen and is being validated against the chain.
`DEPOSIT_CONFIRMED`	The deposit is validated and recorded.
`TRADE_PENDING`	A conversion trade has been queued.
`TRADE_EXECUTING`	The conversion trade is executing.
`SETTLEMENT_PENDING`	Conversion is done (or skipped); funds are being settled to the destination.
`COMPLETED`	Funds have settled to the destination address.
`FAILED`	The transaction could not be completed.
`CANCELLED`	The transaction was cancelled.

📘
Same-currency shortcut
When the deposit currency already matches destinationCurrency, the transaction skips the trade stages and moves straight to SETTLEMENT_PENDING.

Supported networks

Deposits are accepted on the following source networks:

EVM: Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Chain (Binance)
Solana

Set chain to a specific network, or to EVM to accept deposits across all supported EVM networks with a single address.