跳到主要内容

产转账资

API说明​

此API允许在现货账户和资金账户之间进行资产转账，以实现高效的资金管理。

注意：资产转账只能通过 RESTful API可用。

注意事项​

无

认证​

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

请求方法​

POST

接口地址​

/api/v1/private?command=spotWealthTransfer

频率限制​

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

请求参数​

参数必填类型描述
accountTypeTrueString源账户类型：
WEALTH：资金账户，
SPOT：现货账户
targetAccountTypeTrueString目标账户类型：
WEALTH：资金账户，
SPOT：现货账户
bizTypeTrueString转账方向：
WEALTH_TO_SPOT：资金账户到现货账户，
SPOT_TO_WEALTH：现货账户到资金账户。
coinCodeTrueString交易品种的基础货币，例如BTC
amountTrueBigDecimal以基础币种计的转账金额。

响应参数​

参数类型描述
dataBooleanTrue
msgStringSUCCESS

请求示例​

以下Python代码展示了如何从资金账户向现货账户转账。

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

api_url = "/api/v1/private?command=spotWealthTransfer"
method = "post"
params = {
    "accountType" :  "WEALTH",
    "targetAccountType" : "SPOT",
    "bizType" :  "WEALTH_TO_SPOT" ,
    "coinCode" :  "BTC",
    "amount"  : 0.0001,
}
SpotRestfulPrivate(host, api_url, method, api_key, params, secret_key) # 函数SpotRestfulPrivate()在章节(简介 > 认证和代码示例 > 现货 > RESTful私有接口)中定义

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

响应示例​

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

{'code': '200',
 'data': True,
 'msg': 'SUCCESS',
 'success': True,
 'failed': False}