跳到主要内容

获取子母划转记录

描述

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

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"

请求参数

参数名参数类型是否必须描述
subUidString子账户UID,如不传,则获取母账户的划转记录
roleString转出账户类型
initiator 发起转账方
receiver 接收转账方
默认为initiator
coinString币种名称
startTimeString划转记录的查询开始时间
  • Unix毫秒时间戳,例如1690196141868
  • startTime和endTime的时间间隔不超过90天
endTimeString划转记录的查询结束时间
  • Unix毫秒时间戳,例如1690196141868
  • startTime和endTime的时间间隔不超过90天
clientOidString划转自定义订单ID,不能超过64个字符
limitString每页条目数
默认值为100,最大值为100
cursorString游标ID
用于翻页,首次查询不传,查询第二页及后面的数据时,取上一次查询返回的cursor
返回示例
{
"code": "00000",
"msg": "success",
"requestTime": 1751453670468,
"data": {
"list": [
{
"transferId": "1320888751047921664",
"fromType": "spot",
"toType": "uta",
"amount": "20.00000000",
"coin": "USDT",
"fromUserId": "6841950428",
"toUserId": "6841950428",
"status": "Successful",
"clientOid": "1320888751047921664",
"createdTime": "1750650339853",
"updatedTime": "1750650339853",
"oldTransferId": "182797214"
},
{
"transferId": "1314821589514407936",
"fromType": "spot",
"toType": "isolated_margin",
"amount": "1.00000000",
"coin": "USDT",
"fromUserId": "6841950428",
"toUserId": "6841950428",
"status": "Successful",
"clientOid": "1314821589514407936",
"createdTime": "1749203815821",
"updatedTime": "1749203815821",
"oldTransferId": "175609331"
}
],
"cursor": "2"
}
}

返回参数

返回字段参数类型字段说明
cursorString游标ID
listList划转记录列表
> transferIdString划转订单ID
> fromTypeString转出账户类型
spot 现货账户/资金账户
p2p P2P账户/OTC账户
usdt_futures U本位合约账户
coin_futures 币本位合约账户
usdc_futures USDC合约账户
crossed_margin 全仓杠杆账户
unified 统一账户

> toTypeString转入账户类型
spot 现货账户/资金账户
p2p P2P账户/OTC账户
usdt_futures U本位合约账户
coin_futures 币本位合约账户
usdc_futures USDC合约账户
crossed_margin 全仓杠杆账户
unified 统一账户

> amountString划转数量
> coinString划转币种
> fromUserIdString转出账户UID
> toUserIdString转入账户UID
> statusString划转状态
Successful 成功
Failed 失败
Processing 处理中
> clientOidString划转自定义订单ID
> oldTransferIdString原划转订单ID
> createdTimeString划转创建时间,Unix毫秒时间戳
> updatedTimeString划转更新时间,Unix毫秒时间戳

您的阅读体验如何?