Withdraw

Frequency limit:10 times/1s (UID)

Description

Coin withdrawals including on-chain withdrawals and internal transfers(the address needs to be added in the address book on web)

HTTP Request

• POST /api/v2/spot/wallet/withdrawal-new

Request Example

curl -X POST "https://api.cointr.com/api/v2/spot/wallet/withdrawal-new" \  
-H "ACCESS-KEY:your apiKey" \  
-H "ACCESS-SIGN:*" \  
-H "ACCESS-PASSPHRASE:*" \  
-H "ACCESS-TIMESTAMP:1659076670000" \  
-H "locale:en-US" \  
-H "Content-Type: application/json" \  
-d '{"coin":"USDT","transferType":"internal_transfer","address":"*******************************************","chain":"trc20","size":"0.009","recipientName":"Miraç","recipientType":"1","recipientInfo":"946656000000","withdrawalReason":"Transfer to my own account"}'

Request Parameters

Parameter	Type	Required	Description
coin	String	Yes	Coin All coin names can be returned from Get Coin Info interface
transferType	String	Yes	The type of withdrawal on_chain: withdrawal on chain internal_transfer: Transfer internally
address	String	Yes	Withdrawal address when transferType is on_chain, it represents the chain address When transferType is internal_transfer, according the innerToType parameter, please input the UID, email or the mobile
chain	String	No	Chain network e.g. erc20, trc20, etc. This field must be passed when the transferType is on-chain. You can get the chain names via Get Coin Info interface
innerToType	String	No	Type of address for internal withdrawals email: Email address mobile: Mobile phone number uid: UID The default value is uid
areaCode	String	No	This field is required when the value of the collection address type is mobile
tag	String	No	Address tag Some special coins need this field, e.g. EOS
size	String	Yes	Withdrawal amount Special instructions for Bitcoin Lightning Network withdrawals: 1.This parameter must be filled in with a value that is equal to the deposit amount of your invoice on the Bitcoin Lightning Network; 2.The value of size is the credited amount, excluding fees; The decimal places of withdrawal amount will be returned by the Get Coin Info interface
remark	String	No	Note
clientOid	String	No	Client Unique Customized Id
recipientName	String	Yes	Recipient Name, name or company name, Turkish only, special characters and numbers are not supported
recipientType	String	Yes	Recipient Info Type, enter in the corresponding number 1. place of birth (Please fill in the correct address) 2. date of birth (Please enter a number that includes the year, month, and day) 3. customer number 4. national identity number (Please enter 11 digits) 5. passport number (Please enter a combination of numbers and uppercase letters, a total of 8-9 characters) 6. tax identification number (Please enter 10 digits) 7. Address (Please fill in the correct address)
recipientInfo	String	Yes	Recipient Info Content, enter the content corresponding to the number of recipientType
withdrawalReason	String	Yes	The reason for the withdrawal, enter in the corresponding number, or enter some other reason 1. Transfer to my own account 2. Commercial payment 3. E-Commerce Payment 4. Individual Payment 5. Investment Transaction 6. Debt Payment 7. Betting Payment Other (If the Other option is selected, a free text field opens and the customer writes his/her own transaction description)

Response Example

{
    "code": "00000",
    "msg": "success",
    "requestTime": 1695808949356,
    "data": {
        "orderId": "123",
        "clientOid": "123"
    }
}

Response Parameters

Parameter	Type	Description
orderId	String	Order ID
clientOid	String	Custom order ID