Transfers & Withdrawals

private/withdraw

Submits a signed request to withdraw a spot asset out of a subaccount. You provide the subaccount id, asset name, amount in underlying units, a nonce, the signer, an EIP-712 signature with its expiry, and the maximum sequencer fee (in USD) you authorise; setting force_batch controls whether the withdrawal is batched. Requires a session key with withdraw permission, and returns the accepted operation id and its uuid for tracking.

post/private/withdraw

Request

  • Base URL: https://api.derive.xyz/v3
  • URL: https://api.derive.xyz/v3/private/withdraw
  • Auth: none declared

Request body

amount_in_underlyingstring required
asset_namestring required
force_batchboolean required
max_fee_usdstring decimal required

Maximum sequencer fee the signer authorises, in USD, as a decimal string (e.g. "1.5") or a JSON number.

noncestring required
recipientstring nullable

L1 address the funds are paid out to. Defaults to the subaccount's owner wallet when omitted.

A non-owner signer (session key) may only pay out to an address on the owner's whitelisted_recipients, unless the key holds Admin.

signaturestring required
signature_expiry_secinteger required
signerstring required
subaccount_idinteger required

Response

Success

op_uuidstring required
operation_idinteger required

Changes

No recorded changes to this operation across all 1 revision of this API.