Transaction Management
Frequently Asked Questions about Transaction Management
How to query the transaction details of a batch withdraw request?
You can use the GET /v1/custody/transactions_by_request_ids/ endpoint
to query the transaction details of a batch withdraw request submitted under a Custodial Wallet. The request IDs should be provided in the request_ids
field of the GET request, separated by commas.
For an MPC Wallet, you can use the GET /v1/custody/mpc/transactions_by_request_ids/ endpoint instead. A maximum of 50 request IDs can be included in a single request.
How do I query the details of a pending transaction?
You may use the GET /v1/custody/pending_transactions/
endpoint to query the details of a pending transaction under a Custodial Wallet. For an MPC Wallet, you may refer to the status
field with code 501 CONFIRMATION in any transactional APIs to retrieve the details of a pending transaction.
Prior to using any endpoints, however, you need to first head to Cobo Custody Web and enable the “Transaction Notification - Includes Block Confirmation Number” Status feature.
Failure to enable this feature will result in the inability to fetch transaction information. For more information, please refer to /api-references/development/transaction-notification. Do note that some transactions cannot be retrieved due to fast on-chain confirmations (e.g., TRON).
How can I retrieve transaction records for all wallets?
There are several methods to retrieve wallet transaction records:
- API Callback: Enable the Transaction Notification feature on the Cobo Custody Web and set up the Cobo API callback service to retrieve transaction records. Click here for more information.
- Cobo Custody Web: Visit the Cobo Custody Web and navigate to the corresponding wallet. Switch to the “Transactions” tab and export transaction records using available filters.
- API Call: Use the ”transactions_by_time” endpoint to fetch a transaction list that contains details such as transaction hash, amount, and timestamp. Filter the returned data using parameters such as time range, coin type, transaction type (e.g., withdraw, deposit), and address.
- API Call: Use the ”transaction_history” endpoint to query transaction records for a specific coin and address. Filter the returned data using parameters such as side, max_id, min_id, begin_time, end_time, and include_financial. The maximum number of transactions that can be returned is 50.
In rare instances where an on-chain transaction that has been successfully confirmed is rolled back, how will Cobo handle the transaction that should have been credited?
For Cobo Full Custody: If a transaction has reached the required number of confirmations but is later rolled back due to a hard fork, we will contact you promptly to resolve the issue.
For Cobo MPC Co-Managed Custody and MPC Lite: The transaction confirmation count serves only as a reference (provided by Cobo). You maintain complete control over your blockchain addresses, enabling you to autonomously manage rolled-back transactions without requiring Cobo’s assistance.
- How to query the transaction details of a batch withdraw request?
- How do I query the details of a pending transaction?
- How can I retrieve transaction records for all wallets?
- In rare instances where an on-chain transaction that has been successfully confirmed is rolled back, how will Cobo handle the transaction that should have been credited?