Get Transaction By Txid

request(
  'GET',
  '/v1/custody/transaction_by_txid/',
  {
    "txid": "239861be9a4afe080c359b7fe4a1d035945ec46256b1a0f44d1267c71de8ec28",
  },
  api_key, api_secret, host
)

{
  "success": true,
  "result": {
    "id": "20210112173820000166329000003582",
    "coin": "BTC",
    "display_code": "BTC",
    "description": "Bitcoin",
    "decimal": 8,
    "address": "19AR6YWEGbSoY8UT9Ksy9WrmrZPD5sL4Ku",
    "source_address": "bc1q0qfzuge7vr5s2xkczrjkccmxemlyyn8mhx298v",
    "side": "withdraw",
    "amount": "80000",
    "abs_amount": "0.0008",
    "txid": "239861be9a4afe080c359b7fe4a1d035945ec46256b1a0f44d1267c71de8ec28",
    "vout_n": 0,
    "request_id": "web_send_by_user_327_1610444045047",
    "status": "success",
    "abs_cobo_fee": "0",
    "request_created_time": 1610444045158,
    "created_time": 1610445878970,
    "last_time": 1610445878970,
    "confirmed_num": 3,
    "remark":"hello test",
    "tx_detail": {
      "txid": "239861be9a4afe080c359b7fe4a1d035945ec46256b1a0f44d1267c71de8ec28",
      "blocknum": 665711,
      "blockhash": "00000000000000000007137dde44472364eb80126b7d98c12ffb8d37ba11ad33",
      "fee": 0,
      "actualgas": 17812,
      "gasprice": 1,
      "hexstr": ""
    },
    "source_address_detail": "bc1q0qfzuge7vr5s2xkczrjkccmxemlyyn8mhx298v",
    "memo": "",
    "confirming_threshold": 3,
    "fee_coin": "BTC",
    "fee_amount": 50000,
    "fee_decimal": 8,
    "type": "external",
    "tx_request_type": ""
  }
}

GET

https://api.dev.cobo.com

custody

transaction_by_txid

request(
  'GET',
  '/v1/custody/transaction_by_txid/',
  {
    "txid": "239861be9a4afe080c359b7fe4a1d035945ec46256b1a0f44d1267c71de8ec28",
  },
  api_key, api_secret, host
)

{
  "success": true,
  "result": {
    "id": "20210112173820000166329000003582",
    "coin": "BTC",
    "display_code": "BTC",
    "description": "Bitcoin",
    "decimal": 8,
    "address": "19AR6YWEGbSoY8UT9Ksy9WrmrZPD5sL4Ku",
    "source_address": "bc1q0qfzuge7vr5s2xkczrjkccmxemlyyn8mhx298v",
    "side": "withdraw",
    "amount": "80000",
    "abs_amount": "0.0008",
    "txid": "239861be9a4afe080c359b7fe4a1d035945ec46256b1a0f44d1267c71de8ec28",
    "vout_n": 0,
    "request_id": "web_send_by_user_327_1610444045047",
    "status": "success",
    "abs_cobo_fee": "0",
    "request_created_time": 1610444045158,
    "created_time": 1610445878970,
    "last_time": 1610445878970,
    "confirmed_num": 3,
    "remark":"hello test",
    "tx_detail": {
      "txid": "239861be9a4afe080c359b7fe4a1d035945ec46256b1a0f44d1267c71de8ec28",
      "blocknum": 665711,
      "blockhash": "00000000000000000007137dde44472364eb80126b7d98c12ffb8d37ba11ad33",
      "fee": 0,
      "actualgas": 17812,
      "gasprice": 1,
      "hexstr": ""
    },
    "source_address_detail": "bc1q0qfzuge7vr5s2xkczrjkccmxemlyyn8mhx298v",
    "memo": "",
    "confirming_threshold": 3,
    "fee_coin": "BTC",
    "fee_amount": 50000,
    "fee_decimal": 8,
    "type": "external",
    "tx_request_type": ""
  }
}

Only successful deposit/withdraw requests will be considered as ‘Transaction’ here

Request

txid

String

required

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

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/transaction_by_txid/',
  {
    "txid": "239861be9a4afe080c359b7fe4a1d035945ec46256b1a0f44d1267c71de8ec28",
  },
  api_key, api_secret, host
)

{
  "success": true,
  "result": {
    "id": "20210112173820000166329000003582",
    "coin": "BTC",
    "display_code": "BTC",
    "description": "Bitcoin",
    "decimal": 8,
    "address": "19AR6YWEGbSoY8UT9Ksy9WrmrZPD5sL4Ku",
    "source_address": "bc1q0qfzuge7vr5s2xkczrjkccmxemlyyn8mhx298v",
    "side": "withdraw",
    "amount": "80000",
    "abs_amount": "0.0008",
    "txid": "239861be9a4afe080c359b7fe4a1d035945ec46256b1a0f44d1267c71de8ec28",
    "vout_n": 0,
    "request_id": "web_send_by_user_327_1610444045047",
    "status": "success",
    "abs_cobo_fee": "0",
    "request_created_time": 1610444045158,
    "created_time": 1610445878970,
    "last_time": 1610445878970,
    "confirmed_num": 3,
    "remark":"hello test",
    "tx_detail": {
      "txid": "239861be9a4afe080c359b7fe4a1d035945ec46256b1a0f44d1267c71de8ec28",
      "blocknum": 665711,
      "blockhash": "00000000000000000007137dde44472364eb80126b7d98c12ffb8d37ba11ad33",
      "fee": 0,
      "actualgas": 17812,
      "gasprice": 1,
      "hexstr": ""
    },
    "source_address_detail": "bc1q0qfzuge7vr5s2xkczrjkccmxemlyyn8mhx298v",
    "memo": "",
    "confirming_threshold": 3,
    "fee_coin": "BTC",
    "fee_amount": 50000,
    "fee_decimal": 8,
    "type": "external",
    "tx_request_type": ""
  }
}

Feel free to share your feedback to improve our documentation!

Get Transactions By Request IDs Get Transactions By Time

⌘I

Overview

Custodial Wallets API

MPC Wallets API

Development

Request

Response

Overview

Custodial Wallets API

MPC Wallets API

Development

​Request

​Response

Request

Response