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

GET

https://api.dev.cobo.com

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[]

Show object

String

Cobo Unique Transaction ID

coin

String

Coin code (Cobo has internal symbols for each coin to ensure they are all unique)

display_code

String

Coin ticker symbol (not unique, changeable, for reference only)

description

String

Full name of coin (not unique, changeable, for reference only)

address

String

Deposit address

memo

String

Memo for specified coins(EOS,XLM,XRP,IOST)

source_address

String

Source address

source_address_detail

String

Separate by comma if more than one source address

side

enum(deposit / withdraw)

Transaction type

amount

String

Transaction value (Note that the value here contains decimals. For example, a BTC value of 100,000,000 here is actually 1 BTC)

decimal

Int

Amount decimal

abs_amount

String

Transaction value (Note that this is an absolute value. If you trade 1.5 BTC, then the value is 1.5)

abs_cobo_fee

String

lute fee value. For examle, abs_cobo_fee 0.00005 means exactly 0.00005BTC

txid

String

Transaction ID, which can be found on the corresponding public chain

vout_n

String

For transactions on public blockchains that allow for multiple deposit addresses in a single transaction, this value indicates the transaction index on the corresponding public blockchain

request_id

String

Request ID

status

enum(success / failed / pending)

Transaction status. If using the 'pending_transaction' and 'pending_transaction' interfaces for querying, the status can only be 'pending'

request_created_time

Long

Withdraw request creation time

created_time

Long

Transaction creation time

last_time

Long

Transaction success/failure time

confirming_threshold

Int

Confirmed numbers required for a successful transaction

confirmed_num

Int

Confirmed numbers

remark

String

Transaction remark

tx_detail

object

Show object

txid

string

transaction ID

blocknum

Int

block height

blockhash

string

block hash

fee

Int

tx fee

actualgas

Int

Actual Gas consumption, not denominated in Ethereum as a transaction fee.

gasprice

Int

Gas price, not denominated in Ethereum is 1

hexstr

Int

original transaction

fee_coin

String

Fee coin code

fee_amount

Int

Fee amount (Note that the value here contains decimals. For example, a BTC value of 100,000,000 here is actually 1 BTC)

fee_decimal

Int

Fee decimal

type

String

external, internal shows if it's a Loop tx or external(on-chain)

waiting_audit

Bool

When a transaction is in the pending state for deposit transactions and requires auditing, "waiting_audit" is set to true. For withdraw transactions, it always returns false.

tx_request_type

Int

Transaction Request Type	Code
REQUEST_FROM_WEB	100
REQUEST_FROM_API	200
REQUEST_FROM_GAS_STATION	1500

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!

Get Transaction Details Get Transactions By Request IDs

⌘I

Overview

Custodial Wallets API

MPC Wallets API

Development

Request

Response

Overview

Custodial Wallets API

MPC Wallets API

Development

​Request

​Response

Request

Response