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
Request Example
curl -X POST "https://api.cointr.com/api/v2/spot/wallet/withdrawal" \
-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","internal_withdraw","address": "*******************************************","chain": "trc20","size": "0.009"}
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 withdrawalon_chain : withdrawal on chaininternal_transfer : Transfer internally |
address | String | Yes | Withdrawal address when transferType is on_chain , it represents the chain addressWhen 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 withdrawalsemail : Email addressmobile : Mobile phone numberuid : UIDThe 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 |
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 |