Accounts
Virtual account (parent): your organisation’s top-level balance account. It aggregates chain-specific sub-accounts (one wallet per chain) that ZBX provisions and manages. Depositing directly to a sub-account’s wallet address funds your balance. Fiat accounts: chain-less: your fiat ledger holds fiat balances (USD, EUR, GBP). A fiat external account is a bank account you register (once per currency) and ZBX verifies: fiat off-ramp settlement is delivered there. See API guide for registration. Accounts are addressed by numericaccount_id or by your own account_reference string, interchangeably.
Assets and amounts
An asset is a currency symbol +chain_id (for example USDC on 137). Fiat has no chain (chain_id omitted or 0). Token contract addresses are resolved by ZBX on the Quick Trade and Sweep Trade endpoints: you never pass them there (the low-level RFQ endpoints use explicit token addresses).
All monetary amounts are decimal strings ("2500.75"), never floats. Responses round to the asset’s precision (commonly 6 dp for many tokens, 2 dp for fiat).
Quotes and orders
A quote (rfq_…) is a firm all-in price. Automated quotes are valid for 10 seconds. Quick Trade requests and accepts the quote in one atomic call, so you never race expiry yourself.
An order is the execution of an accepted quote: the unit you track. Terminal success: status = Closed with settlement_status = Completed.
Order lifecycle
Trades funded from an existing ZBX balance (normal Quick Trade path) skip
WaitingDeposit and start in Processing.