Get Deposit And Withdraw History
Search for all existed withdraws and deposits and return their latest status. (Authentication type:KEYED, See Interface Permission)
Request Format
GET https://api-cloud.bitmart.com/account/v1/deposit-withdraw/history
Request Limit
Request Parameter
| Field | Type | Required? | Description |
|---|---|---|---|
| currency | string | No | Token symbol, e.g., 'BTC' |
| operation_type | string | Yes | type |
deposit=deposit |
|||
withdraw=withdraw |
|||
| offset | int | Yes | The current page starts at 1 |
| limit | int | Yes | Number of returns per page (value range 1-50) |
Instruction
Only the last 100 records can be retrieved, and requests exceeding 100 will return an empty response. (offset * limit > 100)
Request example
curl https://api-cloud.bitmart.com/account/v1/deposit-withdraw/history?limit=10&offset=1&operationType=withdraw
Response Data
| Field | Type | Description |
|---|---|---|
| withdraw_id | string | withdraw id |
| deposit_id | string | deposit id |
| operation_type | string | type |
deposit=deposit |
||
withdraw=withdraw |
||
| currency | string | Token symbol, e.g., 'BTC' |
| apply_time | long | The request timestamp is accurate to milliseconds(UTC-0) |
| arrival_amount | string | Actual amount received |
| fee | string | fee |
| status | int | status |
0-Create |
||
1-Submitted, waiting for withdrawal |
||
2-Processing |
||
3-Success |
||
4-Cancel |
||
5-Fail |
||
| address | string | Address |
| address_memo | string | Address tag |
| tx_id | string | Hash record |
Instruction
The deposit id has a value when
operation_type= 'deposit'. The withdraw id has a value whenoperation_type= 'withdraw'.Tx_id is an empty string before it is chained.
Example of returned data format
{
"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":""
},
...
]
}
}