Get Transactions List

request(
    "GET",
    "/v1/custody/mpc/list_transactions/",
    {
        "start_time": "",
        "end_time": "",
        "status": 900,
        "order_by": "",
        "order": "",
        "transaction_type": 303,
        "coins": "",
        "from_address": "",
        "to_address": "",
        "limit": 2
    },
    api_key, api_secret, host
)

{
  "success": true,
  "result": {
    "total": 28,
    "transactions": [
      {
        "cobo_id": "20221219161751000350944000003727",
        "request_id": "1671437866485",
        "status": 900,
        "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": "10",
          "abs_amount": "0.00000000000000001"
        },
        "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": 99609,
          "gas_limit": 21000,
          "fee_used": 2091789000
        },
        "source_addresses": null,
        "from_address": "0x2a7670f4e84fe06a26ea1aa6bcdd23f03b3bbfc1",
        "to_address": "0xEEACb7a5e53600c144C0b9839A834bb4b39E540c",
        "tx_hash": "0x224cd23f20a8dfbbe5418871f6a32ddee4463b31e77b5090e7efff1bd8bb6b74",
        "vout_n": 0,
        "nonce": 0,
        "confirmed_number": 32,
        "replace_cobo_id": "",
        "transaction_type": 303,
        "operation": 100,
        "block_detail": {
          "block_hash": "0x5d74fb7415f10d5308599c0ca037e622da7aea75cb5e0af20d492f9d5e8150ab",
          "block_height": 8162134,
          "block_time": 1671438048000
        },
        "tx_detail": {
          "tx_hash": "0x224cd23f20a8dfbbe5418871f6a32ddee4463b31e77b5090e7efff1bd8bb6b74"
        },
        "extra_parameters": "",
        "created_time": 1671437871175,
        "updated_time": 1671438549853,
        "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": "",
        "gas_station_child_id": ""
      },
      {
        "cobo_id": "20221219192126000352912000006483",
        "request_id": "test_002",
        "status": 900,
        "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": "1",
          "abs_amount": "0.000000000000000001"
        },
        "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": 4362985,
          "gas_limit": 21000,
          "fee_used": 91622685000
        },
        "source_addresses": null,
        "from_address": "0x2a7670f4e84fe06a26ea1aa6bcdd23f03b3bbfc1",
        "to_address": "0xEEACb7a5e53600c144C0b9839A834bb4b39E540c",
        "tx_hash": "0x532770380f9418849782fb01f5b62189d44b999b153767fee26ade7592b89888",
        "vout_n": 0,
        "nonce": 1,
        "confirmed_number": 33,
        "replace_cobo_id": "",
        "transaction_type": 303,
        "operation": 0,
        "block_detail": {
          "block_hash": "0x779a310c97d50d8c49e417d5518132221a7052ce3dfe7df5c2857444235b98fc",
          "block_height": 8162891,
          "block_time": 1671449160000
        },
        "tx_detail": {
          "tx_hash": "0x532770380f9418849782fb01f5b62189d44b999b153767fee26ade7592b89888"
        },
        "extra_parameters": "",
        "created_time": 1671448916625,
        "updated_time": 1671449659725,
        "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

https://api.dev.cobo.com

custody

mpc

list_transactions

request(
    "GET",
    "/v1/custody/mpc/list_transactions/",
    {
        "start_time": "",
        "end_time": "",
        "status": 900,
        "order_by": "",
        "order": "",
        "transaction_type": 303,
        "coins": "",
        "from_address": "",
        "to_address": "",
        "limit": 2
    },
    api_key, api_secret, host
)

{
  "success": true,
  "result": {
    "total": 28,
    "transactions": [
      {
        "cobo_id": "20221219161751000350944000003727",
        "request_id": "1671437866485",
        "status": 900,
        "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": "10",
          "abs_amount": "0.00000000000000001"
        },
        "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": 99609,
          "gas_limit": 21000,
          "fee_used": 2091789000
        },
        "source_addresses": null,
        "from_address": "0x2a7670f4e84fe06a26ea1aa6bcdd23f03b3bbfc1",
        "to_address": "0xEEACb7a5e53600c144C0b9839A834bb4b39E540c",
        "tx_hash": "0x224cd23f20a8dfbbe5418871f6a32ddee4463b31e77b5090e7efff1bd8bb6b74",
        "vout_n": 0,
        "nonce": 0,
        "confirmed_number": 32,
        "replace_cobo_id": "",
        "transaction_type": 303,
        "operation": 100,
        "block_detail": {
          "block_hash": "0x5d74fb7415f10d5308599c0ca037e622da7aea75cb5e0af20d492f9d5e8150ab",
          "block_height": 8162134,
          "block_time": 1671438048000
        },
        "tx_detail": {
          "tx_hash": "0x224cd23f20a8dfbbe5418871f6a32ddee4463b31e77b5090e7efff1bd8bb6b74"
        },
        "extra_parameters": "",
        "created_time": 1671437871175,
        "updated_time": 1671438549853,
        "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": "",
        "gas_station_child_id": ""
      },
      {
        "cobo_id": "20221219192126000352912000006483",
        "request_id": "test_002",
        "status": 900,
        "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": "1",
          "abs_amount": "0.000000000000000001"
        },
        "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": 4362985,
          "gas_limit": 21000,
          "fee_used": 91622685000
        },
        "source_addresses": null,
        "from_address": "0x2a7670f4e84fe06a26ea1aa6bcdd23f03b3bbfc1",
        "to_address": "0xEEACb7a5e53600c144C0b9839A834bb4b39E540c",
        "tx_hash": "0x532770380f9418849782fb01f5b62189d44b999b153767fee26ade7592b89888",
        "vout_n": 0,
        "nonce": 1,
        "confirmed_number": 33,
        "replace_cobo_id": "",
        "transaction_type": 303,
        "operation": 0,
        "block_detail": {
          "block_hash": "0x779a310c97d50d8c49e417d5518132221a7052ce3dfe7df5c2857444235b98fc",
          "block_height": 8162891,
          "block_time": 1671449160000
        },
        "tx_detail": {
          "tx_hash": "0x532770380f9418849782fb01f5b62189d44b999b153767fee26ade7592b89888"
        },
        "extra_parameters": "",
        "created_time": 1671448916625,
        "updated_time": 1671449659725,
        "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": ""
      }
    ]
  }
}

Request

start_time

Int

≥ start time (unit: milliseconds); details of transactions whose creation times are equal to or later than this timestamp will be returned

end_time

Int

＜ end time (unit: milliseconds); details of transactions whose creation times are earlier than this timestamp will be returned

status

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
REORG	902

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.

order_by

String

sorting method; default: created_time; other option: modified_time

order

String

sorting order; options: ASC (default), DESC

transaction_type

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

coins

String

coin codes; separated by commas

from_address

String

from address

to_address

String

to address

limit

Int

entries per page; max: 50; default: 50

Response

success

bool

request successful or failed

result

object[]

Show object

total

Int

Total number of transactions that meets the requirements

transactions

object[]

Show object

cobo_id

String

Unique transaction ID

request_id

String

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

status

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
REORG	902

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.

The 902 status indicates that the blockchain has undergone a reorganization and the transaction is no longer part of the confirmed chain, the transaction may either get confirmed again in a later block or fail altogether. The 902 status currently only applies to deposit transactions. If you have credited the funds after the transaction status reached 501, please implement the appropriate logic to handle potential rollbacks after the 902 status.

coin_detail

object

Show object

coin

String

Coin code

chain_code

String

Chain code

display_code

String

Abbreviation (reference only, subject to change)

description

String

Full name (reference only, subject to change)

decimal

Int

Decimal precision

can_deposit

Bool

Whether deposit is supported

can_withdraw

Bool

Whether withdraw is supported

confirming_threshold

Int

Number of confirmations required (may fluctuate)

amount_detail

object

Show object

amount

String

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

abs_amount

String

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

fee_detail

object

Show object

fee_coin_detail

object

Show object

coin

String

The coin symbol

chain_code

String

Chain code

display_code

String

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

description

String

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

decimal

Int

Coin balance decimal places

can_deposit

Bool

Deposit accessibility

can_withdraw

Bool

Withdraw accessibility

confirming_threshold

Int

Confirming threshold of the coin

gas_price

Int

Gas Price

gas_limit

Int

Gas limit

fee_used

Int

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

fee

Float

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

max_fee_amount

Int

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

source_addresses

List

List of ‘from addresses’

from_address

String

From address

to_address

String

To address

memo

String

Memo for specified coins(XRP)

tx_hash

String

Transaction hash

vout_n

Int

UTXO transaction index

nonce

Int

nonce value of a transaction on Ethereum

confirmed_number

Int

Number of block confirmations

replace_cobo_id

String

transaction ID of a transaction replaced via RBF

transaction_type

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

operation

Int

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

block_detail

object

Show object

block_hash

String

Block hash

block_height

Int

Block height

block_time

Int

Block time

tx_detail

object

Show object

tx_hash

String

transaction hash

selected_utxos

object[]

Show object

address

String

UTXO address

tx_hash

String

UTXO transaction hash

vout_n

Int

UTXO transaction index

value

Int

UTXO value

target_destinations

object[]

Show object

address

String

target address

value

Int

target value

is_change

Bool

If is output for change

extra_parameters

Json

Extra parameters specified when constructing the transaction

created_time

Int

Creation time of the transaction

updated_time

Int

Last time the transaction is updated

failed_reason

String

Reasons for rejection

to_address_details

Json

to_address details specified when constructing the transaction

approval_process

Json

Approval flow

signature

String

Signature

remark

String

The remark to withdraw

gas_station_child_id

String

Request ID of the corresponding gas station refueling transaction

is_gas_station_tx

Bool

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

request(
    "GET",
    "/v1/custody/mpc/list_transactions/",
    {
        "start_time": "",
        "end_time": "",
        "status": 900,
        "order_by": "",
        "order": "",
        "transaction_type": 303,
        "coins": "",
        "from_address": "",
        "to_address": "",
        "limit": 2
    },
    api_key, api_secret, host
)

{
  "success": true,
  "result": {
    "total": 28,
    "transactions": [
      {
        "cobo_id": "20221219161751000350944000003727",
        "request_id": "1671437866485",
        "status": 900,
        "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": "10",
          "abs_amount": "0.00000000000000001"
        },
        "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": 99609,
          "gas_limit": 21000,
          "fee_used": 2091789000
        },
        "source_addresses": null,
        "from_address": "0x2a7670f4e84fe06a26ea1aa6bcdd23f03b3bbfc1",
        "to_address": "0xEEACb7a5e53600c144C0b9839A834bb4b39E540c",
        "tx_hash": "0x224cd23f20a8dfbbe5418871f6a32ddee4463b31e77b5090e7efff1bd8bb6b74",
        "vout_n": 0,
        "nonce": 0,
        "confirmed_number": 32,
        "replace_cobo_id": "",
        "transaction_type": 303,
        "operation": 100,
        "block_detail": {
          "block_hash": "0x5d74fb7415f10d5308599c0ca037e622da7aea75cb5e0af20d492f9d5e8150ab",
          "block_height": 8162134,
          "block_time": 1671438048000
        },
        "tx_detail": {
          "tx_hash": "0x224cd23f20a8dfbbe5418871f6a32ddee4463b31e77b5090e7efff1bd8bb6b74"
        },
        "extra_parameters": "",
        "created_time": 1671437871175,
        "updated_time": 1671438549853,
        "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": "",
        "gas_station_child_id": ""
      },
      {
        "cobo_id": "20221219192126000352912000006483",
        "request_id": "test_002",
        "status": 900,
        "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": "1",
          "abs_amount": "0.000000000000000001"
        },
        "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": 4362985,
          "gas_limit": 21000,
          "fee_used": 91622685000
        },
        "source_addresses": null,
        "from_address": "0x2a7670f4e84fe06a26ea1aa6bcdd23f03b3bbfc1",
        "to_address": "0xEEACb7a5e53600c144C0b9839A834bb4b39E540c",
        "tx_hash": "0x532770380f9418849782fb01f5b62189d44b999b153767fee26ade7592b89888",
        "vout_n": 0,
        "nonce": 1,
        "confirmed_number": 33,
        "replace_cobo_id": "",
        "transaction_type": 303,
        "operation": 0,
        "block_detail": {
          "block_hash": "0x779a310c97d50d8c49e417d5518132221a7052ce3dfe7df5c2857444235b98fc",
          "block_height": 8162891,
          "block_time": 1671449160000
        },
        "tx_detail": {
          "tx_hash": "0x532770380f9418849782fb01f5b62189d44b999b153767fee26ade7592b89888"
        },
        "extra_parameters": "",
        "created_time": 1671448916625,
        "updated_time": 1671449659725,
        "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": ""
      }
    ]
  }
}

Feel free to share your feedback to improve our documentation!

Get Supported NFT Collections Get Transactions By Request ID

⌘I

Overview

Custodial Wallets API

MPC Wallets API

Development

Request

Response

Overview

Custodial Wallets API

MPC Wallets API

Development

​Request

​Response

Request

Response