查询充提记录
查询充提记录 (鉴权类型:KEYED, 参见接口权限)
请求格式
GET https://api-cloud.bitmart.com/account/v1/deposit-withdraw/history
请求限制
参见 速率限制详细
请求参数
| 字段 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| currency | string | 可选 | 币种，如 BTC |
| operation_type | string | 必填 | 类型 |
deposit=充值 |
|||
withdraw=提现 |
|||
| offset | int | 必填 | 当前页 从 1 开始 |
| limit | int | 必填 | 每页返回数量(取值范围1-50) |
解释说明
只能获取最近100条记录，请求超出 100 条会返回空响应。(offset * limit > 100)
请求示例
curl https://api-cloud.bitmart.com/account/v1/deposit-withdraw/history?limit=10&offset=1&operationType=withdraw
响应详情
| 字段 | 类型 | 描述 |
|---|---|---|
| withdraw_id | string | 提现ID |
| deposit_id | string | 充值ID |
| operation_type | string | 类型 |
deposit=充值 |
||
withdraw=提现 |
||
| currency | string | 币种，如 BTC |
| apply_time | long | 请求时间戳精确到毫秒(UTC-0) |
| arrival_amount | string | 实际到账金额 |
| fee | string | 手续费 |
| status | int | 状态 |
0-创建 |
||
1-已提交,等待提现 |
||
2-处理中 |
||
3-处理成功 |
||
4-已撤销 |
||
5-处理失败 |
||
| address | string | 地址 |
| address_memo | string | 地址标签 |
| tx_id | string | 提币哈希记录 |
解释说明
- 当
operation_type=deposit时，deposit_id 才有值。 当operation_type=withdraw时，withdraw_id 才有值。 - 还未上链时，tx_id 是空字符串。
返回数据格式示例
{
"message":"OK",
"code":1000,
"trace":"142bf92a-fc50-4689-92b6-590886f90b97",
"data":{
"records":[
{
"withdraw_id":"1679952",
"deposit_id":"",
"operation_type":"withdraw",
"currency":"BMX",
"apply_time":1588867374000,
"arrival_amount":"59.000000000000",
"fee":"1.000000000000",
"status":0,
"address":"0xe57b69a8776b37860407965B73cdFFBDFe668Bb5",
"address_memo":"",
"tx_id":""
},
...
]
}
}