Withdraw assets

REQUEST wss://ws.bitvavo.com/v2 privateWithdrawAssets

Request to withdraw assets to a wallet or bank account.

info

Authentication required. To send messages, you need to authenticate connection.

warning

2FA and address confirmation by email are disabled for withdrawals using the API.

Rate limit weight points: 1

Request

Schema

Body

actionstring
Set value to privateWithdrawAssets.
Example: privateWithdrawAssets
requestIdinteger
Your identifier for the request.
Example: 1
symbolstringrequired
The asset you want to withdraw.
Example: BTC
amountstringrequired
The quantity of the asset to withdraw.
Example: 1.5
addressstringrequired
The address where to withdraw assets.

Make sure to check the address. Funds can not be recovered after being withdrawn to the wrong address.
Example: BitcoinAddress
paymentIdstring
The unique identifier of the transaction of a digital asset. It is sometimes called note, memo, or tag. Should be specified when withdrawing straight to another exchange or merchants that require a paymentId.
Example: 10002653
addWithdrawalFeeboolean
Indicates if a fee is added in addition to the requested amount. If false, the fee is part of the requested amount and subtracted from the withdrawal.
Default value: false
internalbooleandeprecated
Deprecated Do not use or set to false to avoid errors.
Default value: false

Example (body)

{
  "action": "privateWithdrawAssets",
  "requestId": 1,
  "symbol": "BTC",
  "amount": "1.5",
  "address": "BitcoinAddress",
  "paymentId": "10002653",
  "addWithdrawalFee": false,
  "internal": false
}

Response

Schema

Schema

actionstring
The action performed.
Example: privateWithdrawAssets
requestIdinteger
Your identifier for the request.
Example: 1
response object
successboolean
Indicates if the withdrawal request was successful.
Example: true
symbolstring
The asset that was withdrawn.
Example: BTC
amountstring
The total amount deducted from your balance.
Example: 1.5

Example (body)

{
  "action": "privateWithdrawAssets",
  "requestId": 1,
  "response": {
    "success": true,
    "symbol": "BTC",
    "amount": "1.5"
  }
}