Skip to main content
POST
/
api
/
v4
/
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>' \
  --header 'X-TXC-PAYLOAD: <api-key>' \
  --header 'X-TXC-SIGNATURE: <api-key>' \
  --data '
{
  "ticker": "ETH",
  "amount": "0.9",
  "address": "0x0964A6B8F794A4B8d61b62652dB27ddC9844FB4c",
  "unique_id": "24529041",
  "request": "{{request}}",
  "nonce": "{{nonce}}"
}
'
[]
Example:
  • When creating a base withdraw with amount = 100 USD, the receiver receives 100 USD minus the fee, and the balance decreases by 100 USD.
  • When calling the endpoint with amount = 100 USD, the receiver receives 100 USD, and the balance decreases by 100 USD + fee amount.

Authorizations

​
X-TXC-APIKEY
string
header
required

The public WhiteBIT API key.

​
X-TXC-PAYLOAD
string
header
required

Base64-encoded JSON request body.

​
X-TXC-SIGNATURE
string
header
required

HMAC-SHA512 signature of the payload, hex-encoded. Computed as hex(HMAC-SHA512(payload, api_secret)).

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.

Example:

"ETH"

​
amount
string
required

Withdraw amount (including fee). To add the fee to the specified amount, use the /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"

​
unique_id
string
required

Unique transaction identifier. ⚠️ Generate a new unique ID for each withdrawal request.

Example:

"24529041"

​
request
string
required

Request signature

Example:

"{{request}}"

​
nonce
string
required

Unique request identifier

Example:

"{{nonce}}"

​
memo
string

Required if currency is memoable. See memo for details.

Example:

"48565488244493"

​
provider
string

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

Example:

"VISAMASTER"

​
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

Example:

"ERC20"

​
partialEnable
boolean

Optional parameter for FIAT withdrawals with increased Maximum Limit if set as "true". To use this parameter, the application must support "Partially successful" withdrawal status and latest updates in deposit/withdrawal history.

Example:

false

​
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 the account is from EEA

Response

Validation succeeded and withdraw creation process is started. Check the request status by uniqueId in deposit/withdraw history.