Cobo Developer Hub

request(
    "GET",
    "/v1/custody/mpc/transactions_by_request_ids/",
    {
        "request_ids": "web_send_by_user_915_1671699717647",
        "status": 101
    },
    api_key, api_secret, host
)

coboFetch('GET', '/v1/custody/mpc/transactions_by_request_ids/', {
    "request_ids": "web_send_by_user_915_1671699717647",
    "status": 101
}, api_key, api_secret, host)
    .then(res => {
        res.json().then((data)=>{
            console.log(JSON.stringify(data, null, 4));
        })
    }).catch(err => {
        console.log(err)
    });

Request("GET", "/v1/custody/mpc/transactions_by_request_ids/", map[string]string{
    "request_ids": "web_send_by_user_915_1671699717647",
    "status": 101
})

{
  "success": true,
  "result": {
    "total": 28,
    "transactions": [
      {
        "cobo_id": "20221222170157000336673000008161",
        "request_id": "web_send_by_user_915_1671699717647",
        "status": 101,
        "coin_detail": {
          "coin": "GETH",
          "display_code": "GETH",
          "description": "Ethereum Goerli Testnet",
          "decimal": 18,
          "can_deposit": True,
          "can_withdraw": True,
          "confirming_threshold": 32
        },
        "amount_detail": {
          "amount": "9000000000000000",
          "abs_amount": "0.009"
        },
        "fee_detail": {
          "fee_coin_detail": {
            "coin": "GETH",
            "display_code": "GETH",
            "description": "Ethereum Goerli Testnet",
            "decimal": 18,
            "can_deposit": True,
            "can_withdraw": True,
            "confirming_threshold": 32
          },
          "gas_price": 300000000,
          "gas_limit": 21000,
          "fee_used": 0
        },
        "source_addresses": "",
        "from_address": "0x3ede1e59a3f3a66de4260df7ba3029b515337e5c",
        "to_address": "0x9414933Ff7777bb28cA22D15c178596A6e58d957",
        "tx_hash": "",
        "vout_n": 0,
        "nonce": null,
        "confirmed_number": 0,
        "replace_cobo_id": "",
        "transaction_type": 303,
        "operation": 100,
        "block_detail": {
          "block_hash": "",
          "block_height": 0,
          "block_time": 0
        },
        "tx_detail": {
          "tx_hash": ""
        },
        "extra_parameters": "",
        "created_time": 1671699717956,
        "updated_time": 1671699717956,
        "failed_reason": null,
        "max_priority_fee": null,
        "max_fee": null,
        "approval_process": {"spender_result": 1, "spender_review_threshold": 1, "spender_status": [{"spender_person": "Cobo_Test_spender", "status": "approve"}], "spender_complete_time": 1681906749496, "approver_result": 1, "approver_review_threshold": 1, "approver_status": [{"approve_person": "Cobo_Test_approver", "status": "approve"}], "approver_complete_time": 1681906758619},
        "remark": "",
        "memo": "",
        "gas_station_child_id": ""
      }
    ]
  }
}

GET

custody

mpc

transactions_by_request_ids

request(
    "GET",
    "/v1/custody/mpc/transactions_by_request_ids/",
    {
        "request_ids": "web_send_by_user_915_1671699717647",
        "status": 101
    },
    api_key, api_secret, host
)

coboFetch('GET', '/v1/custody/mpc/transactions_by_request_ids/', {
    "request_ids": "web_send_by_user_915_1671699717647",
    "status": 101
}, api_key, api_secret, host)
    .then(res => {
        res.json().then((data)=>{
            console.log(JSON.stringify(data, null, 4));
        })
    }).catch(err => {
        console.log(err)
    });

Request("GET", "/v1/custody/mpc/transactions_by_request_ids/", map[string]string{
    "request_ids": "web_send_by_user_915_1671699717647",
    "status": 101
})

{
  "success": true,
  "result": {
    "total": 28,
    "transactions": [
      {
        "cobo_id": "20221222170157000336673000008161",
        "request_id": "web_send_by_user_915_1671699717647",
        "status": 101,
        "coin_detail": {
          "coin": "GETH",
          "display_code": "GETH",
          "description": "Ethereum Goerli Testnet",
          "decimal": 18,
          "can_deposit": True,
          "can_withdraw": True,
          "confirming_threshold": 32
        },
        "amount_detail": {
          "amount": "9000000000000000",
          "abs_amount": "0.009"
        },
        "fee_detail": {
          "fee_coin_detail": {
            "coin": "GETH",
            "display_code": "GETH",
            "description": "Ethereum Goerli Testnet",
            "decimal": 18,
            "can_deposit": True,
            "can_withdraw": True,
            "confirming_threshold": 32
          },
          "gas_price": 300000000,
          "gas_limit": 21000,
          "fee_used": 0
        },
        "source_addresses": "",
        "from_address": "0x3ede1e59a3f3a66de4260df7ba3029b515337e5c",
        "to_address": "0x9414933Ff7777bb28cA22D15c178596A6e58d957",
        "tx_hash": "",
        "vout_n": 0,
        "nonce": null,
        "confirmed_number": 0,
        "replace_cobo_id": "",
        "transaction_type": 303,
        "operation": 100,
        "block_detail": {
          "block_hash": "",
          "block_height": 0,
          "block_time": 0
        },
        "tx_detail": {
          "tx_hash": ""
        },
        "extra_parameters": "",
        "created_time": 1671699717956,
        "updated_time": 1671699717956,
        "failed_reason": null,
        "max_priority_fee": null,
        "max_fee": null,
        "approval_process": {"spender_result": 1, "spender_review_threshold": 1, "spender_status": [{"spender_person": "Cobo_Test_spender", "status": "approve"}], "spender_complete_time": 1681906749496, "approver_result": 1, "approver_review_threshold": 1, "approver_status": [{"approve_person": "Cobo_Test_approver", "status": "approve"}], "approver_complete_time": 1681906758619},
        "remark": "",
        "memo": "",
        "gas_station_child_id": ""
      }
    ]
  }
}

FAQ：How to query the transaction details of a batch withdraw request?

Request

String

required

Transaction request IDs; separated by commas; the number of IDs must be greater than 0 and less than 50

Int

Status Type	Code
PENDING_APPROVAL	101
QUEUED	201
PENDING_SIGNATURE	301
BROADCASTING	401
BROADCAST_FAILED	402
PENDING_CONFIRMATION	403
CONFIRMATION	501
REVERTING	502
SUCCESS	900
FAILED	901

The 403 status indicates that the transaction has been successfully broadcast but not yet confirmed, while the 501 status indicates that the transaction has been successfully confirmed on the blockchain and is awaiting further confirmations.

Response

bool

request successful or failed

object

Show object

Int

Total number of transactions that meets the requirements

object[]

Show object

String

Unique transaction ID

String

Transaction request ID; it can be left empty if the transaction is a deposit

Int

Status Type	Code
PENDING_APPROVAL	101
QUEUED	201
PENDING_SIGNATURE	301
BROADCASTING	401
BROADCAST_FAILED	402
PENDING_CONFIRMATION	403
CONFIRMATION	501
REVERTING	502
SUCCESS	900
FAILED	901

The 402 status is not the final status of the transaction and will be rebroadcast, but there will still be broadcast failures.

The 502 status indicates that during the confirmation process on the blockchain, the transaction execution has failed. Once the required number of confirmations is reached, the transaction status will change to 901.

object

Show object

String

Coin code

String

Chain code

String

Abbreviation (reference only, subject to change)

String

Full name (reference only, subject to change)

Int

Decimal precision

Bool

Whether deposit is supported

Bool

Whether withdraw is supported

Int

Number of confirmations required (may fluctuate)

object

Show object

String

Transaction amount (e.g. one bitcoin is divisible to eight decimal places, and 100000000 represents 1 BTC)

String

Absolute value of the transaction amount (for instance, 1.5 will be displayed for a transaction amount of 1.5 BTC)

object

Show object

object

Show object

String

The coin symbol

String

Chain code

String

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

String

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

Int

Coin balance decimal places

Bool

Deposit accessibility

Bool

Withdraw accessibility

Int

Confirming threshold of the coin

Int

Gas Price

Int

Gas limit

Int

Gas fees (e.g. one bitcoin is divisible to eight decimal places, and 100000000 represents 1 BTC)

Float

transaction fees per byte, which is specified when constructing the transaction; applicable to UTXO model

Int

limit of fee amount, which is specified when constructing the transaction; applicable to UTXO model

List

List of ‘from addresses’

String

From address

String

To address

String

Memo for specified coins(XRP)

String

Transaction hash

Int

UTXO transaction index

Int

nonce value of a transaction on Ethereum

Int

Number of block confirmations

String

transaction ID of a transaction replaced via RBF

Int

only use in non-web3 wallet:

Transaction Type	Code
TYPE_MPC_WEB	100
TYPE_MPC_API	102
TYPE_RBF_API_SPEEDUP	103
TYPE_RBF_WEB_SPEEDUP	104
TYPE_RBF_API_DROP	105
TYPE_RBF_WEB_DROP	106
TYPE_MPC_TRANSACTION_FROM_EXTERNAL	107
TYPE_MPC_RESEND_WEB	108
TYPE_MPC_BABYLON_STAKE	500
TYPE_MPC_BABYLON_STAKE_RBF	501
TYPE_FROM_DEPOSIT	1000

only use in web3 wallet:

Transaction Type	Code
TYPE_MPC_WEB3_WEB	300
TYPE_MPC_WEB3_MMI_TX	301
TYPE_MPC_WEB3_API_TRANSACTION	303
TYPE_MPC_WEB3_TRANSACTION_FROM_EXTERNAL	307
TYPE_MPC_WEB3_RBF_API_SPEEDUP	308
TYPE_MPC_WEB3_RBF_WEB_SPEEDUP	309
TYPE_MPC_WEB3_RBF_API_DROP	310
TYPE_MPC_WEB3_RBF_WEB_DROP	311
TYPE_FROM_DEPOSIT	1000

Int

action type; it will be empty if the action is making a deposit (TRANSFER: 100, CONTRACT_CALL: 200)

object

Show object

String

Block hash

Int

Block height

Int

Block time

object

Show object

String

transaction hash

object[]

Show object

String

UTXO address

String

UTXO transaction hash

Int

UTXO transaction index

Int

UTXO value

object[]

Show object

String

target address

Int

target value

Bool

If is output for change

Json

Extra parameters specified when constructing the transaction

Int

Creation time of the transaction

Int

Last time the transaction is updated

String

Reasons for rejection

Json

to_address details specified when constructing the transaction

Json

Approval flow

String

Signature

String

The remark to withdraw

String

Request ID of the corresponding gas station refueling transaction

Bool

Whether is gas station refueling transaction, applicable to transactions with transaction_type 1000

request(
    "GET",
    "/v1/custody/mpc/transactions_by_request_ids/",
    {
        "request_ids": "web_send_by_user_915_1671699717647",
        "status": 101
    },
    api_key, api_secret, host
)

coboFetch('GET', '/v1/custody/mpc/transactions_by_request_ids/', {
    "request_ids": "web_send_by_user_915_1671699717647",
    "status": 101
}, api_key, api_secret, host)
    .then(res => {
        res.json().then((data)=>{
            console.log(JSON.stringify(data, null, 4));
        })
    }).catch(err => {
        console.log(err)
    });

Request("GET", "/v1/custody/mpc/transactions_by_request_ids/", map[string]string{
    "request_ids": "web_send_by_user_915_1671699717647",
    "status": 101
})

{
  "success": true,
  "result": {
    "total": 28,
    "transactions": [
      {
        "cobo_id": "20221222170157000336673000008161",
        "request_id": "web_send_by_user_915_1671699717647",
        "status": 101,
        "coin_detail": {
          "coin": "GETH",
          "display_code": "GETH",
          "description": "Ethereum Goerli Testnet",
          "decimal": 18,
          "can_deposit": True,
          "can_withdraw": True,
          "confirming_threshold": 32
        },
        "amount_detail": {
          "amount": "9000000000000000",
          "abs_amount": "0.009"
        },
        "fee_detail": {
          "fee_coin_detail": {
            "coin": "GETH",
            "display_code": "GETH",
            "description": "Ethereum Goerli Testnet",
            "decimal": 18,
            "can_deposit": True,
            "can_withdraw": True,
            "confirming_threshold": 32
          },
          "gas_price": 300000000,
          "gas_limit": 21000,
          "fee_used": 0
        },
        "source_addresses": "",
        "from_address": "0x3ede1e59a3f3a66de4260df7ba3029b515337e5c",
        "to_address": "0x9414933Ff7777bb28cA22D15c178596A6e58d957",
        "tx_hash": "",
        "vout_n": 0,
        "nonce": null,
        "confirmed_number": 0,
        "replace_cobo_id": "",
        "transaction_type": 303,
        "operation": 100,
        "block_detail": {
          "block_hash": "",
          "block_height": 0,
          "block_time": 0
        },
        "tx_detail": {
          "tx_hash": ""
        },
        "extra_parameters": "",
        "created_time": 1671699717956,
        "updated_time": 1671699717956,
        "failed_reason": null,
        "max_priority_fee": null,
        "max_fee": null,
        "approval_process": {"spender_result": 1, "spender_review_threshold": 1, "spender_status": [{"spender_person": "Cobo_Test_spender", "status": "approve"}], "spender_complete_time": 1681906749496, "approver_result": 1, "approver_review_threshold": 1, "approver_status": [{"approve_person": "Cobo_Test_approver", "status": "approve"}], "approver_complete_time": 1681906758619},
        "remark": "",
        "memo": "",
        "gas_station_child_id": ""
      }
    ]
  }
}

Get Transactions List Get Transactions By Cobo ID

⌘I

Overview

Custodial Wallets API

MPC Wallets API

Development

Get Transactions By Request ID

Request

Response

​Request

​Response

Request

Response