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":""
},
...
]
}
}