Create withdraw request with specific withdraw amount (fee not included)

curl --request POST \
  --url https://whitebit.com/api/v4/main-account/withdraw-pay \
  --header 'Content-Type: application/json' \
  --header 'X-TXC-APIKEY: <api-key>' \
  --data '
{
  "ticker": "<string>",
  "amount": "<string>",
  "address": "<string>",
  "uniqueId": "<string>",
  "request": "<string>",
  "nonce": "<string>",
  "memo": "<string>",
  "provider": "<string>",
  "network": "<string>",
  "partialEnable": true,
  "beneficiary": {},
  "travelRule": {}
}
'

[]

Main Balance

Create withdraw request with the specific withdraw amount (fee is not included)

This endpoint has the similar logic as /main-account/withdraw, but with the only difference: amount that is specified will not include fee (it will be calculated to make target withdraw amount equal to the specified amount).

Example:

When you create base withdraw and set amount = 100 USD, receiver will receive 100 USD - fee amount, and your balance will decrease by 100 USD.
When you use this endpoint and set amount = 100 USD, receiver will receive 100 USD, and your balance will decrease by 100 USD + fee amount.

Rate limit: 1000 requests/10 sec.

Response is cached for: NONE

POST

api

main-account

withdraw-pay

Create withdraw request with specific withdraw amount (fee not included)

curl --request POST \
  --url https://whitebit.com/api/v4/main-account/withdraw-pay \
  --header 'Content-Type: application/json' \
  --header 'X-TXC-APIKEY: <api-key>' \
  --data '
{
  "ticker": "<string>",
  "amount": "<string>",
  "address": "<string>",
  "uniqueId": "<string>",
  "request": "<string>",
  "nonce": "<string>",
  "memo": "<string>",
  "provider": "<string>",
  "network": "<string>",
  "partialEnable": true,
  "beneficiary": {},
  "travelRule": {}
}
'

[]

Example:

When you create base withdraw and set amount = 100 USD, receiver will recieve 100 USD - fee amount, and your balance will decrease by 100 USD.
When you use this endpoint and set amount = 100 USD, receiver will recieve 100 USD, and your balance will decrease by 100 USD + fee amount.

Authorizations

X-TXC-APIKEY

string

header

required

API key authentication using signed requests

Body

application/json

ticker

string

required

Currencies ticker. Example: BTC ⚠️ Currencies ticker must have "can_deposit" status equal to "true". Use Asset Status endpoint to know more about currency.

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

address

string

required

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

uniqueId

string

required

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

request

string

required

Request signature

nonce

string

required

Unique request identifier

memo

string

Required if currency is memoable. See memo for details.

provider

string

Fiat currency provider. Example: VISAMASTER ⚠️ Currency provider should be taken from Asset Status endpoint response. Required if currency is fiat.

network

string

Cryptocurrency network. Available for multinetwork currencies. Example: OMNI ⚠️ Currency network should be taken from Asset Status endpoint response. Default for USDT is 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. Required if currency ticker is one of: UAH_IBAN, USD_VISAMASTER, EUR_VISAMASTER, USD, EUR

travelRule

object

Travel Rule information data. Required if currency is crypto and you are from EEA

Response

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

Create withdraw request Transfer between balances

⌘I