Skip to main content

Withdraw assets

POST 
/withdrawal

Request to withdraw assets to a wallet or bank account.

info

This is a private endpoint. To send requests, you need to authenticate.

warning

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

Rate limit weight points: 1

Request​

Body

    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
    internalbooleandeprecated

    Deprecated Do not use or set to false to avoid errors.

    Default value: false
    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

Responses​

The request was successful.

Response Headers
    bitvavo-ratelimit-remaining

    The number of remaining weight points before it resets at bitvavo-ratelimit-resetat.

    bitvavo-ratelimit-resetat

    The time when bitvavo-ratelimit-remaining resets to bitvavo-ratelimit-limit.

    bitvavo-ratelimit-limit

    The number of available weight points in one minute.

Schema
    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