跳到主要内容

发起提现

API说明

此接口用于发起提现,支持链上转账和CoinW用户之间的内部转账。必需参数包括金额、地址、链和备注。

注意:历史订单只能通过 RESTful API 获取。

注意事项

认证

这是一个私有接口,需要认证。有关使用RESTful API的详细信息,请参考简介 > 认证和代码示例 > 现货 > RESTful私有接口。

请求方法

POST

接口地址

/api/v1/private?command=doWithdraw

频率限制

该接口的调用频率限制为:每个用户 ID 每秒最多请求3次。
此外,该接口还受到全局频率限制的约束。
有关"全局速率限制"和"API限频策略"的详细信息,请参阅“频率限制”部分,跳转

请求参数

参数必填类型描述
memoTrueString备注
typeFalseStringordinary_withdraw,
internal_transfer
默认:ordinary_withdraw
amountTrueString提现数量
currencyTrueString货币
addressTrueString提现地址:
当"type"为"ordinary_withdraw"时,提供区块链地址。
当"type"为"internal_transfer"时,根据"innerToType"提供用户ID、电子邮件地址或手机号码。
chainTrueString区块链名称,例如 ERC20、TRC20、BSC
innerToTypeTrueInteger内部提现地址类型。当type为internal_transfer时,需要
1. 用户ID,
2. 手机号码,
3. 电子邮件地址。

响应参数

参数类型描述
depositNumberString唯一ID

请求示例

以下Python代码展示了如何提现。

注意:完整代码示例请参考简介 > 认证和代码示例 > 现货 > RESTful私有接口。

api_url = "/api/v1/private?command=doWithdraw"
method = "post"
params = {
"memo" : "None" ,
"type" : "internal_transfer" ,
"amount" : "0.001" ,
"currency" : "BTC" ,
"address" : "3491077",
"chain" : "BTC" ,
"innerToType" : 1 ,
}
SpotRestfulPrivate(host, api_url, method, api_key, params, secret_key) # 函数SpotRestfulPrivate()在章节(简介 > 认证和代码示例 > 现货 > RESTful私有接口)中定义

注意:完整Java代码示例请参考简介 > 认证和代码示例 > 现货 > RESTful私有接口。

响应示例

以下是上述Python请求返回的示例响应:

{'code': '200', 'data': {'depositNumber': '23705'}, 'msg': 'SUCCESS'}