Skip to main content
GET
/
v1
/
custody
/
transactions_by_time
/
request(
  'GET',
  '/v1/custody/transactions_by_time/',
  {
    "coin": "BTC_USDT",
    "side": "deposit",
    "begin_time": 1542191734958
  },
  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.
​
begin_time
Long
Begin timestamp(milliseconds). If set, transactions whose transaction confirmation time is less than or equal to this will not be returned.(cannot be used with end_time)
​
end_time
Long
End timestamp (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)
​
limit
Integer
Page size is optional. If not included, the default size will be 50, and the maximum size will also be 50.
​
include_financial
String
Request all transactions. If it is passed in, return all transactions(Including stacking, trading)

​
Response

​
success
bool
request successful or failed
​
result
object[]
request(
  'GET',
  '/v1/custody/transactions_by_time/',
  {
    "coin": "BTC_USDT",
    "side": "deposit",
    "begin_time": 1542191734958
  },
  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!