获取主子账户划转记录

API说明

此接口用于主账户用户查询主子账户之间的资产划转历史记录，以及不同账户类型之间的内部划转（例如：资产账户 → 现货账户）。

注意：账户之间的划转记录数据只能通过 RESTful API 获取。

注意事项

1. 仅限主账户：此接口仅支持使用主账户的 API Key 查询，子账户的 API Key 无限权查询。
2. 账户类型代码: 请求与响应中的 from 和 to 字段使用特定的整数代码来表示账户类型：
   • 0: 资产账户
   • 1: 现货账户
   • 2: 合约账户
   • 3: 子账户
   • 4: 主账户

认证

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

请求方法

POST

接口地址

/api/v1/private?command=returnTransferHistory

频率限制

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

请求参数

参数	必填	类型	描述
currency	true	String	币种名称。 示例："USDT"
from	true	Integer	源账户类型。 示例：4 表示主账户
to	true	Integer	目标账户类型。 示例：3 表示子账户
pageNo	true	Integer	页码（默认值：1）
pageSize	true	Integer	每页记录数（默认值：10）

响应参数

参数	类型	描述
data	Array	资产划转记录数据列表
-currency	String	币种名称。 示例："USDT"
-createTime	String	交易时间。 格式：YYYY-MM-DD HH:mm:ss
-amount	String	划转数额
-from	Integer	源账户类型。 0: 资产账户 1: 现货账户 2: 合约账户 3: 子账户 4: 主账户
-to	Integer	目标账户类型（枚举值与上述from 相同）
-status	String	交易状态 1：成功 0：失败
-ledgerId	String	唯一交易流水 ID。

请求示例

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

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

api_url = "/api/v1/private?command=returnTransferHistory"
method = "post"
params = {
    "currency": "USDT",
    "from": 4,  # 主账户
    "to": 3,    # 子账户
    "pageNo": 1,
    "pageSize": 10
}

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

响应示例

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

{
    "code": "200",
    "data": [
        {
            "currency": "USDT",
            "createTime": "2025-12-17 17:32:20",
            "amount": "-10",
            "from": 4,
            "to": 3,
            "status": "1",
            "ledgerId": "**************************out"
        },
        {
            "currency": "USDT",
            "createTime": "2025-12-17 17:18:49",
            "amount": "-10",
            "from": 4,
            "to": 3,
            "status": "1",
            "ledgerId": "**************************out"
        }
    ],
    "msg": "SUCCESS",
    "success": true,
    "failed": false
}