Skip to content
Crypto Deposits and Withdrawals

Submit Crypto Withdrawal Request

Submits a crypto withdrawal request with the token, network, quantity, and whitelisted receiving address, and returns the withdrawal record id once accepted. Acceptance means only that the request was submitted; the outcome is determined by the withdrawal record status.

Preconditions: the receiving address is active in the whitelist (addresses marked by is_pending_effect cannot be selected) and has passed the availability check; the quantity does not exceed available_quantity from Get Crypto Withdrawal Preview and is not below the larger of min_per_withdraw and the estimated crypto fee; the remaining withdrawals today are greater than 0; the token price and fee estimate have been retrieved; and the available cash in the securities account can cover the account service fee.

Side effects: creates a withdrawal request and reserves the withdrawable quantity. On success, use the returned id with Query Crypto Withdrawal Records to show the details, and refresh the withdrawal preview. On failure, show message instead of resubmitting immediately.

When calling through WhaleCore requestService(), set requiresTradeToken to true.

A complete withdrawal flow runs in this order: get the token list and the withdrawal preview (GET /v1/atm/va/query/all/coin/list, GET /v1/atm/va/withdraw/coin/preview) → select a network and a whitelisted address and check its availability → get the token price (POST /v1/atm/va/get/coin/prices) → estimate the fee (GET /v1/atm/va/estimate/coin/fee) → submit the withdrawal request → query withdrawal records.

POSThttps://api.lbkrs.com/v1/atm/va/withdraw/coin/apply

Request body application/json

coinstringrequired

Token symbol, such as BTC, ETH, or USDT, taken from coin in Get Crypto Token List.

chain_typestringrequired

Network (chain) name, one of the values in the token chain_types.

quantitystringrequired

Withdrawal quantity, as a decimal string.

wallet_idintegerrequired

Whitelisted receiving address id, taken from wallet_id in Query Whitelisted Address List.

exchange_currencystringrequired

Valuation currency, taken from the token conversion_currency.

exchange_ratestringrequired

Token price, taken from last_done in Get Crypto Prices.

need_crypto_feeboolean

Whether to apply the crypto fee. Keep it consistent with the fee estimate; the withdrawal page passes true.

need_fiat_feeboolean

Whether to apply the account service fee. Keep it consistent with the fee estimate; the withdrawal page passes true.

Responses

HTTP 200The request succeeded. The response body contains the result of the “Submit Crypto Withdrawal Request” operation.
Standard response envelopecodemessagedata
dataobjectdata structure
idinteger

Withdrawal record id, usable as id in Query Crypto Withdrawal Records.

okboolean

Whether the request was accepted.

Whale Docs