跳到主要内容

主子账户资产划转

API说明​

该接口用于主账户与其子账户之间进行资产划转，支持主账户向子账户以及子账户向主账户的双向划转。

注意：主子账户的资产划转只能通过 RESTful API 实现。

注意事项​

  1. 仅限主账户：此接口仅支持使用主账户的 API Key，子账户的 API Key 无限权使用。
  2. side 参数用于定义相对于主账户的划转方向：
    • OUT: 从主账户划转至子账户。
    • IN: 从子账户划转至主账户。
  3. 可划转账户类型：资产划转通常发生在主与子账户的资产账户之间。请在发起划转前确保相关资金已存放于资产账户中。
  4. 子账户间的划转：此接口不支持子账户之间的直接划转。如需在子账户之间转移资产，需先划转至主账户，再由主账户划转至目标子账户。

认证​

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

请求方法​

POST

接口地址​

/api/v1/private?command=subAccount_transfer

频率限制​

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

请求参数​

参数必填类型描述
sidetrueString划转方向。
OUT: 主账户 → 子账户
IN: 子账户 → 主账户
subUidtrueLong指定的子账户 UID
currencytrueString币种名称。
示例："USDT"
amounttrueString/Decimal划转数额

响应参数​

参数类型描述
dataObject划转详情
-bizNoString本次划转的唯一订单号

请求示例​

以下Python代码展示了如何查询主子账户划转记录。

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

api_url = "/api/v1/private?command=subAccount_transfer"
method = "post"
params = {"side": "OUT","subUid": "39*****","currency": "USDT","amount": 10}

SpotRestfulPrivate(host, api_url, method, api_key, params, secret_key) # 函数SpotRestfulPrivate()函数定义于(简介 > 认证和代码示例 > 现货 > RESTful私有接口)章节

响应示例​

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

{
    "code": "200",
    "data": {
        "bizNo": "******************************"
    },
    "msg": "SUCCESS",
    "success": true,
    "failed": false
}