Transaction
Get Transactions By Request ID
Account
Loop Alliance
Transactions
Withdraw
Staking
Trading
Gas Station
Account
Transaction
Withdraw
Tss Node
Bind Auth
Gas Station
Custodial Wallet APIs
MPC Wallet APIs
Transaction
Get Transactions By Request ID
This endpoint returns a JSON response containing transaction information for a list of transaction request IDs. The response includes the transaction ID, request ID, status, and other relevant information. The endpoint requires authentication and accepts optional query parameters to filter the results by transaction status.
GET
/
v1
/
custody
/
mpc
/
transactions_by_request_ids
/
API-SECRET
string
*
API-SECRET
Required
string
request_ids
string
*
request_ids
Required
string
Transaction request IDs; separated by commas; the number of IDs must be greater than 0 and less than 50
status
integer
status
integer
request(
"GET",
"/v1/custody/mpc/transactions_by_request_ids/",
{
"request_ids": "web_send_by_user_915_1671699717647",
"status": 101
},
api_key, api_secret, host
)
{
"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": ""
}
]
}
}
Request
request_ids
String
requiredTransaction request IDs; separated by commas; the number of IDs must be greater than 0 and less than 50
status
Int
Status Type | Code |
---|---|
PENDING_APPROVAL | 101 |
QUEUED | 201 |
PENDING_SIGNATURE | 301 |
BROADCASTING | 401 |
BROADCAST_FAILED | 402 |
PENDING_CONFIRMATION | 403 |
CONFIRMATION | 501 |
SUCCESS | 900 |
FAILED | 901 |
The 403 status indicates that the transaction has been successfully broadcasted, while the 501 status indicates that the transaction has been successfully confirmed on the blockchain and is awaiting further confirmations.
Response
success
bool
request successful or failed
result
object
total
Int
Total number of transactions that meets the requirements
transactions
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 |
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 403 status indicates that the transaction has been successfully broadcasted, while the 501 status indicates that the transaction has been successfully confirmed on the blockchain and is awaiting further confirmations.
coin_detail
object
coin
String
Coin 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
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
fee_coin_detail
object
coin
String
The coin symbol.
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)
source_addresses
List
List of ‘from addresses’
from_address
String
From address
to_address
String
To address
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 |
---|---|
TRANSACTION_FROM_WEB | 100 |
TRANSACTION_FROM_API | 102 |
TRANSACTION_RBF_API_SPEEDUP | 103 |
TRANSACTION_RBF_WEB_SPEEDUP | 104 |
TRANSACTION_RBF_API_DROP | 105 |
TRANSACTION_RBF_WEB_DROP | 106 |
TRANSACTION_FROM_EXTERNAL | 107 |
TRANSACTION_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 |
TRANSACTION_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
block_hash
String
Block hash
block_height
Int
Block height
block_time
Int
Block time
tx_detail
object
tx_hash
String
transaction hash
extra_parameters
Json
Transaction remarks
created_time
Int
Creation time of the transaction
updated_time
Int
Last time the transaction is updated
failed_reason
String
Reasons for rejection
approval_process
Json
Approval flow
remark
String
The remark to withdraw
memo
String
Memo for specified coins(XRP)
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/transactions_by_request_ids/",
{
"request_ids": "web_send_by_user_915_1671699717647",
"status": 101
},
api_key, api_secret, host
)
{
"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": ""
}
]
}
}