获取提币记录

描述

获取提币记录

HTTP请求

• GET /api/v3/account/withdrawal-records
• 限频规则: 10次/s/UID
• 需要统一账户管理只读权限

请求示例

curl "https://api.bitget.com/api/v3/account/withdrawal-records?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	否	币种名称 - 如不填，则获取所有币种充值记录
orderId	String	否	订单ID - 查询单笔订单时，可通过orderId与clientOid二者其一进行查询 - 若同时传入orderId与clientOid，则orderId优先级更高
clientOid	String	否	客户自定义ID - 查询单笔订单时，可通过orderId与clientOid二者其一进行查询 - 若同时传入orderId与clientOid，则orderId优先级更高
startTime	String	是	查询记录起始时间 Unix毫秒时间戳，例如1690196141868
endTime	String	是	查询记录结束时间 Unix毫秒时间戳，例如1690196141868
limit	String	否	每页条目数 默认值为20，最大值为100
cursor	String	否	游标ID - 用于翻页，可缩短查询响应时间 - 首次查询不传，查询第二页及后续数据时，取上一次查询返回的最小orderId，结果会返回小于该值的数据

返回示例

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1740481864545,
  "data": [
      {
        "orderId": "1278112570963742720",
        "clientOid": "12121212112",
        "recordId": "1278112570963742720",
        "coin": "usdt",
        "type": "deposit",
        "dest": "internal_transfer",
        "size": "100",
        "status": "success",
        "fromAddress": "0x51xxx",
        "toAddress": "0x51xxx",
        "chain": "erc20",
        "fee": "10",
        "confirm": "5",
        "tag": "",
        "createdTime": "1740451703778",
        "updatedTime": "1740451703778"
      }
  ]
}

返回参数

返回字段	参数类型	字段说明
orderId	String	订单ID
clientOid	String	自定义订单ID
recordId	String	充值记录ID - 如果dest为on_chain，则为链上哈希值 - 如果dest为internal_transfer，则为订单ID
coin	String	币种名称
type	String	操作类型 withdraw提币
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时可忽略此参数
fee	String	手续费 - 计量单位为提币币种
confirm	String	确认区块数
tag	String	标签
createdTime	String	提币记录创建时间,Unix毫秒时间戳
updatedTime	String	提币记录更新时间,Unix毫秒时间戳