跳到主要内容

获取提币记录

限速规则 10次/1s (UID)

描述

获取提币记录

HTTP请求

  • GET /api/v2/spot/wallet/withdrawal-records
请求示例
curl "https://api.bitget.com/api/v2/spot/wallet/withdrawal-records?coin=USDT&clientOid=123&startTime=1659036670000&endTime=1659076670000&limit=20" \
-H "ACCESS-KEY:*******" \
-H "ACCESS-SIGN:*" \
-H "ACCESS-PASSPHRASE:*" \
-H "ACCESS-TIMESTAMP:1659076670000" \
-H "locale:en-US" \
-H "Content-Type: application/json"

请求参数

参数名参数类型是否必须描述
coinString币种名称,如USDT
clientOidString自定义订单ID。与订单ID二选一,当传入clientOid时直接查询此订单,忽略其他入参
orderIdString提币订单ID。与clientOid二选一,当传入订单ID时直接查询此订单,忽略其他入参
startTimeString查询的记录起始时间。Unix毫秒时间戳,例如1690196141868
endTimeString查询的记录结束时间。Unix毫秒时间戳,例如1690196141868
idLessThanString游标ID
用于翻页,首次查询不传,查询第二页及后面的数据时,取上一次查询返回的最小orderId,结果会返回小于该值的数据;可以缩短查询响应时间
limitString每页条目数
默认值为20,最大值为100
返回示例
{
"code": "00000",
"msg": "success",
"requestTime": 1654507973411,
"data": [
{
"orderId": "1",
"tradeId": "1",
"coin": "USDT",
"dest": "internal_transfer",
"clientOid": "123",
"type": "withdraw",
"tag": "",
"size": "10.00000000",
"fee": "-1.00000000",
"status": "success",
"toAddress": "1",
"fromAddress": "2",
"confirm": "100",
"chain": "erc20",
"cTime": "1653290769222",
"uTime": "1653290769222"
}
]
}

返回参数

返回字段参数类型字段说明
orderIdString提币订单ID
tradeIdString交易ID
如果deston_chain,则为链上交易哈希值
如果destinternal_transfer,则为订单ID
coinString币种名称
clientOidString客户自定义ID
typeString类型
固定为withdraw
destString提币方式
on_chain:链上提币
internal_transfer:内部转账
sizeString数量
statusString提币状态
pending:确认中
fail:失败
success:成功
fromAddressString提币发起方
如果deston_chain,则为链上地址
如果destinternal_transfer,则为UID,email或者mobile
toAddressString提币接收方
如果deston_chain,则为链上地址
如果destinternal_transfer,则为UID,email或者mobile
feeString手续费
chainString提币网络
如果destinternal_transfer时,可忽略此参数
confirmString确认区块数
tagString标签
cTimeString创建时间,毫秒
uTimeString修改时间,毫秒