获取子母划转记录

描述

该接口支持获取子母账户间的划转记录

HTTP请求

• GET /api/v3/account/sub-transfer-record
• 限频规则: 5次/s/UID
• 需要统一账户管理读取权限
• 仅母账户才能调用此接口

请求示例

curl -X GET "https://api.bitget.com/api/v3/account/sub-transfer-record?limit=100" \
   -H "ACCESS-KEY:*******" \
   -H "ACCESS-SIGN:*" \
   -H "ACCESS-PASSPHRASE:*" \
   -H "ACCESS-TIMESTAMP:1659076670000" \
   -H "locale:en-US" \
   -H "Content-Type: application/json"

请求参数

参数名	参数类型	是否必须	描述
subUid	String	否	子账户UID，如不传，则获取母账户的划转记录
role	String	否	转出账户类型 initiator 发起转账方 receiver 接收转账方 默认为initiator
coin	String	否	币种名称
startTime	String	否	划转记录的查询开始时间 Unix毫秒时间戳，例如1690196141868 startTime和endTime的时间间隔不超过90天
endTime	String	否	划转记录的查询结束时间 Unix毫秒时间戳，例如1690196141868 startTime和endTime的时间间隔不超过90天
clientOid	String	否	划转自定义订单ID,不能超过64个字符
limit	String	否	每页条目数 默认值为100，最大值为100
cursor	String	否	游标ID 用于翻页，首次查询不传，查询第二页及后面的数据时，取上一次查询返回的cursor

返回示例

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1740481864545,
  "data": {
    "items": [
      {
        "transferId": "1278112570963742720",
        "fromType": "spot",
        "toType": "spot",
        "amount": "500.00000000",
        "coin": "USDT",
        "fromUserId": "1991021336",
        "toUserId": "5568532724",
        "status": "Successful",
        "clientOid": "2025022500002",
        "createdTime": "1740451703778",
        "updatedTime": "1740451703778"
      },
      {
        "transferId": "1278112136173801472",
        "fromType": "spot",
        "toType": "spot",
        "amount": "100.00000000",
        "coin": "USDT",
        "fromUserId": "1991021336",
        "toUserId": "5568532724",
        "status": "Successful",
        "clientOid": "2025022500001",
        "createdTime": "1740451600116",
        "updatedTime": "1740451600116"
      }
    ],
    "cursor": "272661"
  }
}

返回参数

返回字段	参数类型	字段说明
cursor	String	游标ID
items	Array	划转记录列表
clientOid	String	划转自定义订单ID
> fromType	String	转出账户类型 spot 现货账户/资金账户 p2p P2P账户/OTC账户 usdt_futures U本位合约账户 coin_futures 币本位合约账户 usdc_futures USDC合约账户 crossed_margin 全仓杠杆账户 unified 统一账户
> toType	String	转入账户类型 spot 现货账户/资金账户 p2p P2P账户/OTC账户 usdt_futures U本位合约账户 coin_futures 币本位合约账户 usdc_futures USDC合约账户 crossed_margin 全仓杠杆账户 unified 统一账户
> amount	String	划转数量
> coin	String	划转币种
> fromUserId	String	转出账户UID
> toUserId	String	转入账户UID
> status	String	划转状态 Successful 成功 Failed 失败 Processing 处理中
> clientOid	String	划转自定义订单ID
> createdTime	String	划转创建时间,Unix毫秒时间戳
> updatedTime	String	划转更新时间,Unix毫秒时间戳