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

See Detailed Rate 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

  1. The deposit id has a value when operation_type = 'deposit'. The withdraw id has a value when operation_type = 'withdraw'.

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

results matching ""

    No results matching ""