获取子账户最大可划转资产
API说明
此接口允许主账户用户查询指定子账户在指定币种下的最大可划转资产。并返回指定子账户该币种的最大可划转资产数额。
注意:子账户最大可划转资产的数据只能通过 RESTful API 获取。
注意事项
- 仅限主账户:此接口仅支持使用主账户的 API Key 查询,子账户的 API Key 无限权查询。
- 可划转账户类型:返回值通常为资产账户 (Asset Account) 中的可用余额,现货 / 合约中冻结的资金不计入可划转金额。
认证
这是一个私有接口,需要认证。有关使用 RESTful API 的详细信息,请参考简介 > 认证和代码示例 > 现货 > RESTful 私有接口。
请求方法
POST
接口地址
/api/v1/private?command=subAccount_transferAvailable
频率限制
该接口的调用频率限制为:每个用户 ID 每秒最多请求3次。 此外,该接口还受到全局频率限制的约束。 有关"全局速率限制"和"API限频策略"的详细信息,请参阅“频率限制”部分,跳转
请求参数
| 参数 | 必填 | 类型 | 描述 |
|---|---|---|---|
| coinCode | true | String | 币种名称。 示例:"USDT" |
| subUid | true | Long | 子账户的 UID |
响应参数
| 参数 | 类型 | 描述 |
|---|---|---|
| data | String | 指定币种的最大可划转资产数额 |
请求示例
以下Python代码展示了如何获取子账户最大可划转资产。
注意:完整代码示例请参考简介 > 认证和代码示例 > 现货 > RESTful私有接口。
api_url = "/api/v1/private?command=subAccount_transferAvailable"
method = "post"
params = {"coinCode": "USDT","subUid": "111*****"}
SpotRestfulPrivate(host, api_url, method, api_key, params, secret_key) # 函数SpotRestfulPrivate()函数定义于(简介 > 认证和代码示例 > 现货 > RESTful私有接口)章节
响应示例
以下是上述Python请求返回的示例响应:
{
"code": "200",
"data": "99",
"msg": "SUCCESS",
"success": true,
"failed": false
}