Withdrawals

A withdrawal always goes through a fee calculation: request a quote first, then create the withdrawal with its quoteId.

How it works

Request a fee calculation (quote): the service calculates the fee and the recipient amount but does not create a withdrawal or reserve the balance. A quote is valid for 5 minutes.
Create the withdrawal with the same quoteId and parameters. Balance and permissions are checked again.
Withdrawals are processed asynchronously: requested → queued → broadcasted → confirmed, or failed / cancelled. Every step sends a payout.* webhook.
If the creation response is lost, repeat the same request with the same quoteId — the already created withdrawal is returned.