Skip to main content
GET
/
v1
/
custody
/
transactions_by_id
/
request(
  'GET',
  '/v1/custody/transactions_by_id/',
  {
    "coin": "BTC_USDT",
    "side": "deposit",
    "max_id": 20181114183534062065000000483656
  },
  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.
​
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_id/',
  {
    "coin": "BTC_USDT",
    "side": "deposit",
    "max_id": 20181114183534062065000000483656
  },
  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!