Create withdraw request

Authorizations

X-TXC-APIKEY

string

header

required

API key authentication using signed requests

Body

application/json

ticker

string

required

Currency's ticker. Example: BTC

⚠️ Currencies ticker must have "can_deposit" status equal to "true". Use https://whitebit.com/api/v4/public/assets to know more about currency.

Example:

"ETH"

amount

string

required

Withdraw amount (including fee). If you want fee to be added to the specified amount, you need to use /main-account/withdraw-pay request.

Example:

"0.9"

address

string

required

Target address (wallet address for cryptocurrencies, identifier/card token for fiat currencies)

Example:

"0x0964A6B8F794A4B8d61b62652dB27ddC9844FB4c"

uniqueId

string

required

Unique transaction identifier.

⚠️ Note that you should generate new unique id for each withdrawal request.

Example:

"24529041"

request

string

required

Request signature

nonce

string

required

Unique request identifier

memo

string

Memo.

⚠️ Required if currency is memoable.

provider

string

Fiat currency provider. Example: VISAMASTER

⚠️ Required for fiat currencies. Currency provider should be taken from https://whitebit.com/api/v4/public/assets response.

network

string

Cryptocurrency network. Available for multi network currencies. Example: OMNI

⚠️ Currency network should be taken from https://whitebit.com/api/v4/public/assets response. Default for USDT is ERC20

Example:

"ERC20"

partialEnable

boolean

Optional parameter for FIAT withdrawals with increased Maximum Limit if set as "true". In order to use this parameter your application should support "Partially successful" withdrawal status and latest updates in deposit/withdrawal history.

beneficiary

object

Beneficiary information data array.

⚠️ Required if currency ticker is one of: UAH_IBAN, USD_VISAMASTER, EUR_VISAMASTER, USD, EUR

Show child attributes

beneficiary.firstName

string

Beneficiary first name. Max length: 40 symbols, latin letters and special characters.

⚠️ Required if currency ticker is one of: UAH_IBAN, USD_VISAMASTER, USD, EUR

beneficiary.lastName

string

Beneficiary last name. Max length: 40 symbols, latin letters and special characters.

⚠️ Required if currency ticker is one of: UAH_IBAN, USD_VISAMASTER, USD, EUR

beneficiary.tin

integer

Beneficiary TAX payer number. Integer, 10 digits.

⚠️ Required if currency is UAH_IBAN.

beneficiary.phone

string

Beneficiary phone number.

⚠️ Required if currency ticker is one of: USD_VISAMASTER, EUR_VISAMASTER

beneficiary.email

string

Beneficiary email.

⚠️ Required if currency ticker is one of: USD_VISAMASTER, EUR_VISAMASTER

beneficiary.birthDate

string<date>

Beneficiary birth date. Format: YYYY-MM-DD.

⚠️ Required if currency ticker is one of: USD_VISAMASTER, EUR_VISAMASTER

travelRule

object

Travel Rule information data array.

⚠️ Required if currency is crypto and you are from EEA

Show child attributes

travelRule.type

enum<string>

Travel rule receiver type. Values: "individual" or "entity"

⚠️ Required if currency is crypto and you are from EEA

Available options:

individual,

entity

travelRule.vasp

string

Travel rule destination platform (VASP) name.

⚠️ Required if currency is crypto and you are from EEA

travelRule.name

string

Travel rule. If individual - first_name ; if entity - entity_name

⚠️ Required if currency is crypto and you are from EEA

travelRule.address

string

Travel rule. If individual - last_name ; if entity - entity_address

⚠️ Required if currency is crypto and you are from EEA

paymentDescription

string

Description of withdrawal destination

⚠️ Required if currency is crypto and withdrawal from whitebit-tr.com

Response

Validation succeeded and withdraw creation process is started. Go to deposit/withdraw history and check your request status by uniqueId.