获取子账户充值记录

描述

获取子账户充值记录

HTTP请求

• POST /api/v3/account/sub-deposit-records
• 限频规则: 10次/秒/UID
• 需要统一账户管理只读权限

请求示例

curl "https://api.bitget.com/api/v3/account/sub-deposit-records?subUid=4234324223&startTime=1700561435000&endTime=1703153435933" \
   -H "ACCESS-KEY:*******" \
   -H "ACCESS-SIGN:*" \
   -H "ACCESS-PASSPHRASE:*" \
   -H "ACCESS-TIMESTAMP:1659076670000" \
   -H "locale:en-US" \
   -H "Content-Type: application/json"

请求参数

参数名	参数类型	是否必须	描述
coin	String	否	币种名称 - 如不填，则获取所有币种充值记录
subUid	String	是	子账户UID
startTime	String	是	查询记录起始时间 Unix毫秒时间戳，例如1690196141868
endTime	String	是	查询记录结束时间 Unix毫秒时间戳，例如1690196141868
limit	String	否	每页条目数 默认值为20，最大值为100
cursor	String	否	游标ID - 用于翻页，可缩短查询响应时间 - 首次查询不传，查询第二页及后续数据时，取上一次查询返回的最小orderId，结果会返回小于该值的数据

返回示例

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1730189276579,
  "data": [
    {
      "orderId": "1278112570963742720",
      "recordId": "1278112570963742720",
      "coin": "usdt",
      "type": "deposit",
      "dest": "internal_transfer",
      "size": "1",
      "status": "success",
      "fromAddress": "0x51xxx",
      "toAddress": "0x51xxx",
      "chain": "erc20",
      "createdTime": "1740451703778",
      "updatedTime": "1740451703778"
    }
  ]
}

返回参数

返回字段	参数类型	字段说明
orderId	String	订单ID
recordId	String	充值记录ID - 如果dest为on_chain，则为链上哈希值 - 如果dest为internal_transfer，则为订单ID
coin	String	币种名称
type	String	操作类型 deposit充值
dest	String	充值类型 on_chain链上充值 internal_transfer内部转账
size	String	充值数量
status	String	充值状态 pending确认中 success成功 fail失败
fromAddress	String	充值发起方 - 如果dest为on_chain，则为链上地址 - 如果dest为internal_transfer，则为uid, email或者mobile
toAddress	String	充值接收方 - 如果dest为on_chain，则为链上地址 - 如果dest为internal_transfer，则为uid, email或者mobile
chain	String	充值网络 - dest为internal_transfer时可忽略此参数
createdTime	String	充值记录创建时间,Unix毫秒时间戳
updatedTime	String	充值记录更新时间,Unix毫秒时间戳