获取提币记录
限速规则 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"
请求参数
| 参数名 | 参数类型 | 是否必须 | 描述 |
|---|---|---|---|
| coin | String | 否 | 币种名称,如USDT |
| clientOid | String | 否 | 自定义订单ID。与订单ID二选一,当传入clientOid时直接查询此订单,忽略其他入参 |
| orderId | String | 否 | 提币订单ID。与clientOid二选一,当传入订单ID时直接查询此订单,忽略其他入参 |
| startTime | String | 是 | 查询的记录起始时间。Unix毫秒时间戳,例如1690196141868 |
| endTime | String | 是 | 查询的记录结束时间。Unix毫秒时间戳,例如1690196141868 |
| idLessThan | String | 否 | 游标ID 用于翻页,首次查询不传,查询第二页及后面的数据时,取上一次查询返回的最小orderId,结果会返回小于该值的数据;可以缩短查询响应时间 |
| limit | String | 否 | 每页条目数 默认值为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"
}
]
}
返回参数
| 返回字段 | 参数类型 | 字段说明 |
|---|---|---|
| orderId | String | 提币订单ID |
| tradeId | String | 交易ID 如果 dest为on_chain,则为链上交易哈希值如果 dest为internal_transfer,则为订单ID |
| coin | String | 币种名称 |
| clientOid | String | 客户自定义ID |
| type | String | 类型 固定为 withdraw |
| dest | String | 提币方式on_chain:链上提币internal_transfer:内部转账 |
| size | String | 数量 |
| status | String | 提币状态pending:确认中fail:失败 success:成功 |
| fromAddress | String | 提币发起方 如果 dest为on_chain,则为链上地址如果 dest为internal_transfer,则为UID,email或者mobile |
| toAddress | String | 提币接收方 如果 dest为on_chain,则为链上地址如果 dest为internal_transfer,则为UID,email或者mobile |
| fee | String | 手续费 |
| chain | String | 提币网络 如果 dest为internal_transfer时,可忽略此参数 |
| confirm | String | 确认区块数 |
| tag | String | 标签 |
| cTime | String | 创建时间,毫秒 |
| uTime | String | 修改时间,毫秒 |