To provide cost certainty in a volatile gas environment, withdrawals follow a two-step "Lock and Execute" pattern. This ensures that the network fees and platform-specific withdrawal fees are guaranteed for a specific window of time.
Request a Locked Fee
Before initiating a withdrawal, the platform must request a fee quote. This call calculates the costs based on current network congestion and your specific account configuration.
Key Response Fields
withdrawal_quote_id: The unique identifier for this specific fee lock. This must be passed into the final execution call.network_fee: The estimated miner/gas fee required to broadcast the transaction to the blockchain.withdrawal_fee: The platform-specific processing fee.net_withdrawal_quantity: The actual amount that will be sent to the destination address after all fees are deducted.
Execute Withdrawal
To finalize the movement of funds, the platform must call the execution endpoint using the data provided in the quote.
- Mandatory Linkage: You must include the
withdrawal_quote_idin your execution request. - Validation: The system verifies that the quote is still valid and that the parameters (amount, asset, and destination address) match the original lock request.
- Balance Requirement: Ensure the participant's account has a sufficient "Gross" balance to cover the
amountplus the calculated fees.
