Skip to main content
GET
/
v1
/
custody
/
transaction_history
/
request(
    'GET',
    '/v1/custody/transaction_history/',
    {
        "coin": "BTC_USDT",
        "side": "deposit"
    },
    api_key, api_secret, host
)

{
  "success": true,
  "result": [
    {
        "id": "20221013214833000312228000005846",
        "coin": "BTC_USDT",
        "display_code": "USDT",
        "description": "Tether",
        "decimal": 8,
        "address": "38GewuNXgnbmsxgvGFKd5ZNjUdNavxgEGM",
        "source_address": "AutoTest_RC02",
        "side": "deposit",
        "amount": "6000000",
        "abs_amount": "0.06",
        "txid": "L65954e38419b55abb10b37fc6fca54f",
        "vout_n": 0,
        "request_id": null,
        "status": "success",
        "abs_cobo_fee": "0",
        "created_time": 1665668913144,
        "last_time": 1665668913144,
        "confirmed_num": 3,
        "remark": "",
        "tx_detail": {
            "txid": "L65954e38419b55abb10b37fc6fca54f",
            "blocknum": 0,
            "blockhash": "",
            "fee": 0,
            "actualgas": 0,
            "gasprice": 1,
            "hexstr": ""
        },
        "source_address_detail": "AutoTest_RC02",
        "confirming_threshold": 3,
        "fee_coin": "BTC",
        "fee_decimal": 8,
        "fee_amount": 0,
        "type": "internal",
        "tx_request_type": ""
    },
    {
        "id": "20221013213858000312228000007739",
        "coin": "BTC_USDT",
        "display_code": "USDT",
        "description": "Tether",
        "decimal": 8,
        "address": "38GewuNXgnbmsxgvGFKd5ZNjUdNavxgEGM",
        "source_address": "AutoTest_RC02",
        "side": "deposit",
        "amount": "23000000",
        "abs_amount": "0.23",
        "txid": "L3dbb8e30d8da66c9ea0d7171e1fbe2c",
        "vout_n": 0,
        "request_id": null,
        "status": "success",
        "abs_cobo_fee": "0",
        "created_time": 1665668338625,
        "last_time": 1665668338625,
        "confirmed_num": 3,
        "remark": "",
        "tx_detail": {
            "txid": "L3dbb8e30d8da66c9ea0d7171e1fbe2c",
            "blocknum": 0,
            "blockhash": "",
            "fee": 0,
            "actualgas": 0,
            "gasprice": 1,
            "hexstr": ""
        },
        "source_address_detail": "AutoTest_RC02",
        "confirming_threshold": 3,
        "fee_coin": "BTC",
        "fee_decimal": 8,
        "fee_amount": 0,
        "type": "internal",
        "tx_request_type": ""
    }
  ]
}
Only successful deposit/withdraw requests will be considered as ‘Transaction’ here

​
Request

​
coin
String
Coin code (Does not return all currencies)
​
side
enum(deposit / withdraw)
Deposit/withdraw
​
address
String
Deposit/withdraw address is optional. If not included, all address history will be returned.
​
max_id
String
The transaction history ID limit is optional. If not included, will by default return the most recent records.(cannot be used with min_id)
​
min_id
String
Optional. If included, the sequence will be changed to time ASC. If not included, will by default return the most recent records, time DESC.(cannot be used with max_id)
​
limit
Integer
Page size is optional. If not included, the default size will be 50, and the maximum size will also be 50.
​
begin_time
Long
Begin timestamp(milliseconds). If set, transactions whose confirmation times are shorter than this value will not be returned. (cannot be used with end_time)
​
end_time
Long
End time stamp (milliseconds). If it is passed in, the transactions whose transaction confirmation time is greater than or equal to this will not be returned.(cannot be used with begin_time)
​
include_financial
String
Request all transactions, if they are, return all transactions (including Staking, Trading)

​
Response

​
success
bool
request successful or failed
​
result
object[]
request(
    'GET',
    '/v1/custody/transaction_history/',
    {
        "coin": "BTC_USDT",
        "side": "deposit"
    },
    api_key, api_secret, host
)

{
  "success": true,
  "result": [
    {
        "id": "20221013214833000312228000005846",
        "coin": "BTC_USDT",
        "display_code": "USDT",
        "description": "Tether",
        "decimal": 8,
        "address": "38GewuNXgnbmsxgvGFKd5ZNjUdNavxgEGM",
        "source_address": "AutoTest_RC02",
        "side": "deposit",
        "amount": "6000000",
        "abs_amount": "0.06",
        "txid": "L65954e38419b55abb10b37fc6fca54f",
        "vout_n": 0,
        "request_id": null,
        "status": "success",
        "abs_cobo_fee": "0",
        "created_time": 1665668913144,
        "last_time": 1665668913144,
        "confirmed_num": 3,
        "remark": "",
        "tx_detail": {
            "txid": "L65954e38419b55abb10b37fc6fca54f",
            "blocknum": 0,
            "blockhash": "",
            "fee": 0,
            "actualgas": 0,
            "gasprice": 1,
            "hexstr": ""
        },
        "source_address_detail": "AutoTest_RC02",
        "confirming_threshold": 3,
        "fee_coin": "BTC",
        "fee_decimal": 8,
        "fee_amount": 0,
        "type": "internal",
        "tx_request_type": ""
    },
    {
        "id": "20221013213858000312228000007739",
        "coin": "BTC_USDT",
        "display_code": "USDT",
        "description": "Tether",
        "decimal": 8,
        "address": "38GewuNXgnbmsxgvGFKd5ZNjUdNavxgEGM",
        "source_address": "AutoTest_RC02",
        "side": "deposit",
        "amount": "23000000",
        "abs_amount": "0.23",
        "txid": "L3dbb8e30d8da66c9ea0d7171e1fbe2c",
        "vout_n": 0,
        "request_id": null,
        "status": "success",
        "abs_cobo_fee": "0",
        "created_time": 1665668338625,
        "last_time": 1665668338625,
        "confirmed_num": 3,
        "remark": "",
        "tx_detail": {
            "txid": "L3dbb8e30d8da66c9ea0d7171e1fbe2c",
            "blocknum": 0,
            "blockhash": "",
            "fee": 0,
            "actualgas": 0,
            "gasprice": 1,
            "hexstr": ""
        },
        "source_address_detail": "AutoTest_RC02",
        "confirming_threshold": 3,
        "fee_coin": "BTC",
        "fee_decimal": 8,
        "fee_amount": 0,
        "type": "internal",
        "tx_request_type": ""
    }
  ]
}
Feel free to share your feedback to improve our documentation!