Apply Withdraw(V3)

HTTP REQUEST

POST /api/v3/withdrawals

TIP

On the WEB end, you can open the switch of specified favorite addresses for withdrawal, and when it is turned on, it will verify whether your withdrawal address(including chain) is a favorite address(it is case sensitive); if it fails validation, it will respond with the error message {"msg":"Already set withdraw whitelist, this address is not favorite address","code":"260325"}.

API KEY PERMISSIONS

This endpoint requires the Transfer permission.

REQUEST URL

This endpoint support Spot URL

REQUEST RATE LIMIT

Manage weight：5

PARAMETERS

Param	Type	Mandatory	Description
currency	String	Yes	Currency
toAddress	String	Yes	Withdrawal address, ADDRESS (withdrawal address), UID, MAIL (email), PHONE (mobile phone number).
amount	number	Yes	Withdrawal amount, a positive number which is a multiple of the amount precision (fees excluded)
memo	String	No	Address remark. If there’s no remark, it is empty. When you withdraw from other platforms to the KuCoin, you need to fill in memo(tag). If you do not fill memo (tag), your deposit may not be available, please be cautious.
isInner	boolean	No	Internal withdrawal or not. Default : false
remark	String	No	Remark
chain	String	No	The chain of currency. For a currency with multiple chains, it is recommended to specify chain parameter instead of using the default chain; you can query the chainId through the response of the GET /api/v3/currencies/{currency} interface.
feeDeductType	String	No	Withdrawal fee deduction type: INTERNAL or EXTERNAL or not specified 1. INTERNAL- deduct the transaction fees from your withdrawal amount 2. EXTERNAL- deduct the transaction fees from your main account 3. If you don't specify the feeDeductType parameter, when the balance in your main account is sufficient to support the withdrawal, the system will initially deduct the transaction fees from your main account. But if the balance in your main account is not sufficient to support the withdrawal, the system will deduct the fees from your withdrawal amount. For example: Suppose you are going to withdraw 1 BTC from the KuCoin platform (transaction fee: 0.0001BTC), if the balance in your main account is insufficient, the system will deduct the transaction fees from your withdrawal amount. In this case, you will be receiving 0.9999BTC. 4. Lightning Network can only deduct internally
withdrawType	String	Yes	Withdrawal type, ADDRESS (withdrawal address), UID, MAIL (email), PHONE (mobile phone number). Note: If you withdraw by uid/mail/phone, there will have rate limited: 3 times/10 seconds, 50 times/24 hours (calculated on a rolling basis based on the first request time)

RESPONSES

Param	Description
withdrawalId	Withdrawal id, a unique ID for a withdrawal