Skip to main content
GET
/
transactions
import cobo_waas2
from cobo_waas2.models.list_transactions200_response import ListTransactions200Response
from cobo_waas2.models.wallet_subtype import WalletSubtype
from cobo_waas2.models.wallet_type import WalletType
from cobo_waas2.rest import ApiException
from pprint import pprint

# See configuration.py for a list of all supported configurations.
configuration = cobo_waas2.Configuration(
    # Replace `<YOUR_PRIVATE_KEY>` with your private key
    api_private_key="<YOUR_PRIVATE_KEY>",
    # Select the development environment. To use the production environment, change the URL to https://api.cobo.com/v2.
    host="https://api.dev.cobo.com/v2",
)
# Enter a context with an instance of the API client
with cobo_waas2.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = cobo_waas2.TransactionsApi(api_client)
    request_id = "web_send_by_user_327_1610444045047"
    cobo_ids = "20231213122855000000000000000000,20231213122955000000000000000000"
    transaction_ids = (
        "f47ac10b-58cc-4372-a567-0e02b2c3d479,557918d2-632a-4fe1-932f-315711f05fe3"
    )
    transaction_hashes = (
        "239861be9a4afe080c359b7fe4a1d035945ec46256b1a0f44d1267c71de8ec28"
    )
    types = "Deposit,Withdrawal"
    statuses = "Completed,Failed"
    wallet_ids = (
        "f47ac10b-58cc-4372-a567-0e02b2c3d479,1ddca562-8434-41c9-8809-d437bad9c868"
    )
    chain_ids = "BTC,ETH"
    token_ids = "ETH_USDT,ETH_USDC"
    asset_ids = "USDT,USDC"
    vault_id = "f47ac10b-58cc-4372-a567-0e02b2c3d479"
    wallet_type = cobo_waas2.WalletType("Custodial")
    wallet_subtype = cobo_waas2.WalletSubtype("Asset")
    project_id = "f47ac10b-58cc-4372-a567-0e02b2c3d479"
    min_created_timestamp = 1635744000000
    max_created_timestamp = 1635744000000
    limit = 10
    before = "RqeEoTkgKG5rpzqYzg2Hd3szmPoj2cE7w5jWwShz3C1vyGmk1"
    after = "RqeEoTkgKG5rpzqYzg2Hd3szmPoj2cE7w5jWwShz3C1vyGSAk"
    direction = "ASC"

    try:
        # List all transactions
        api_response = api_instance.list_transactions(
            request_id=request_id,
            cobo_ids=cobo_ids,
            transaction_ids=transaction_ids,
            transaction_hashes=transaction_hashes,
            types=types,
            statuses=statuses,
            wallet_ids=wallet_ids,
            chain_ids=chain_ids,
            token_ids=token_ids,
            asset_ids=asset_ids,
            vault_id=vault_id,
            wallet_type=wallet_type,
            wallet_subtype=wallet_subtype,
            project_id=project_id,
            min_created_timestamp=min_created_timestamp,
            max_created_timestamp=max_created_timestamp,
            limit=limit,
            before=before,
            after=after,
            direction=direction,
        )
        print("The response of TransactionsApi->list_transactions:\n")
        pprint(api_response)
    except Exception as e:
        print("Exception when calling TransactionsApi->list_transactions: %s\n" % e)


{
  "data": [
    {
      "transaction_id": "aff0e1cb-15b2-4e1f-9b9d-a9133715986f",
      "cobo_id": "20231213122855000000000000000000",
      "request_id": "760a1955-e212-4dfb-a8d0-e66312a1a051",
      "wallet_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "type": "Deposit",
      "status": "Submitted",
      "sub_status": "PendingDoubleCheck",
      "failed_reason": "Rejected by signer Cobo TSS",
      "chain_id": "ETH",
      "token_id": "ETH_USDT",
      "asset_id": "USDT",
      "source": {
        "source_type": "DepositFromAddress",
        "wallet_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
      },
      "destination": {
        "destination_type": "Address",
        "account_output": {
          "address": "19AR6YWEGbSoY8UT9Ksy9WrmrZPD5sL4Ku",
          "memo": "82840924",
          "amount": "1.5"
        },
        "utxo_outputs": [
          {
            "address": "19AR6YWEGbSoY8UT9Ksy9WrmrZPD5sDEMO",
            "amount": "1.5"
          }
        ],
        "change_address": "19AR6YWEGbSoY8UT9Ksy9WrmrZPD5sDEMO",
        "force_internal": false,
        "force_external": false
      },
      "result": {
        "result_type": "Signature",
        "signature": "0x6a8d82c2b080c18e7c1d187a95b3d9b0b9b20454d5e1d784b8a4625d16772d3f"
      },
      "fee": {
        "fee_type": "EVM_EIP_1559",
        "token_id": "ETH",
        "effective_gas_price": "100000000",
        "fee_used": "0.1",
        "estimated_fee_used": "0.1",
        "gas_used": "100000000",
        "max_fee_per_gas": "9000000000000",
        "max_priority_fee_per_gas": "1000000000000",
        "gas_limit": "21000"
      },
      "initiator": "API Prod Key #1",
      "initiator_type": "API",
      "confirmed_num": 12,
      "confirming_threshold": 15,
      "transaction_hash": "239861be9a4afe080c359b7fe4a1d035945ec46256b1a0f44d1267c71de8ec28",
      "block_info": {
        "block_number": 123,
        "block_timestamp": 1717740319,
        "block_hash": "0xc9ee947f8bb6027c161888bf0d004bec05e7c2beec7e6b187dc512174e438735"
      },
      "raw_tx_info": {
        "used_nonce": 9,
        "selected_utxos": [
          {
            "tx_hash": "7014d7d9b91862d7131f7543d84da3bec60e20be93c23ad01167c48b778fdemo",
            "vout_n": 0,
            "address": "2N2xFZtbCFB6Nb3Pj9Sxsx5mX2fxX3yEgkE",
            "value": "0.5",
            "redeem_script": "0x1cc56cbbac4622082221a8768d1d0901",
            "revealed_script": "0x1cc56cbbac4622082221a8768d1d0901"
          }
        ],
        "raw_tx": "0xa22cb4650000000000000000000000001e0049783f008a0085193e00003d00cd54003c71000000000000000000000000000000000000000000000000000000000000DEMO",
        "unsigned_raw_tx": "0xa22cb4650000000000000000000000001e0049783f008a0085193e00003d00cd54003c71000000000000000000000000000000000000000000000000000000000000DEMO",
        "utxo_change": {
          "address": "2N2xFZtbCFB6Nb3Pj9Sxsx5mX2fxX3yEgkE",
          "value": "0.5"
        }
      },
      "replacement": {
        "replaced_by_type": "Resend",
        "replaced_by_transaction_id": "aff0e1cb-15b2-4e1f-9b9d-a9133715986f",
        "replaced_by_transaction_hash": "239861be9a4afe080c359b7fe4a1d035945ec46256b1a0f44d1267c71de8ec28",
        "replaced_type": "Resend",
        "replaced_transaction_id": "aff0e1cb-15b2-4e1f-9b9d-a9133715986f",
        "replaced_transaction_hash": "239861be9a4afe080c359b7fe4a1d035945ec46256b1a0f44d1267c71de8ec28"
      },
      "category": [
        "Payment"
      ],
      "description": "withdrawal to exchange trading account",
      "is_loop": false,
      "cobo_category": [
        "AutoFueling"
      ],
      "extra": [
        "{\"extra_type\":\"BabylonBusinessInfo\",\"btc_address_info\":{\"address\":\"tb1p8k9f36798z5wkfd3mlq00cjm82c7sp5hudlqaxkdvfw4xaywvw4qzzv2xz\",\"chain_id\":\"SIGNET_BTC\",\"memo\":\"\",\"path\":\"44/1/5/0/4\",\"encoding\":\"ENCODING_P2TR\",\"pubkey\":\"xpub6FkyaGRDyh4hayxmbY4YX7q9fuuxt14dNoYv5TphsKLnChVXSaTxY7DPwdeN8Yys5FLhfuajG8pshdXWk9cTzBFUy5rVA4Lx9kwmFUqhZcC\",\"x_only_pubkey\":\"\",\"root_pubkey\":\"xpub661MyMwAqRbcGFdLxNuuQvnPTLFs1xHpFQz5iumoDnw4NPofkE8SSrtwUmoy3E52HtcxCH9wXCfhztuuiuusvB3kAb4nt9rT4bkXxujubKm\",\"taproot_script_tree_hash\":\"\",\"taproot_internal_address\":\"\"}}\n"
      ],
      "fueling_info": {
        "request_id": "gas_760a1955-e212-4dfb-a8d0-e66312a1a051",
        "transaction_id": "b0530b27-104f-4338-87de-de01500326ea",
        "main_transaction_id": "b0530b27-104f-4338-87de-de01500326ea"
      },
      "created_timestamp": 1610445878970,
      "updated_timestamp": 1610445878970
    }
  ],
  "pagination": {
    "before": "RqeEoTkgKG5rpzqYzg2Hd3szmPoj2cE7w5jWwShz3C1vyGmk1",
    "after": "RqeEoTkgKG5rpzqYzg2Hd3szmPoj2cE7w5jWwShz3C1vyGSAk",
    "total_count": 10000
  }
}
import cobo_waas2
from cobo_waas2.models.list_transactions200_response import ListTransactions200Response
from cobo_waas2.models.wallet_subtype import WalletSubtype
from cobo_waas2.models.wallet_type import WalletType
from cobo_waas2.rest import ApiException
from pprint import pprint

# See configuration.py for a list of all supported configurations.
configuration = cobo_waas2.Configuration(
    # Replace `<YOUR_PRIVATE_KEY>` with your private key
    api_private_key="<YOUR_PRIVATE_KEY>",
    # Select the development environment. To use the production environment, change the URL to https://api.cobo.com/v2.
    host="https://api.dev.cobo.com/v2",
)
# Enter a context with an instance of the API client
with cobo_waas2.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = cobo_waas2.TransactionsApi(api_client)
    request_id = "web_send_by_user_327_1610444045047"
    cobo_ids = "20231213122855000000000000000000,20231213122955000000000000000000"
    transaction_ids = (
        "f47ac10b-58cc-4372-a567-0e02b2c3d479,557918d2-632a-4fe1-932f-315711f05fe3"
    )
    transaction_hashes = (
        "239861be9a4afe080c359b7fe4a1d035945ec46256b1a0f44d1267c71de8ec28"
    )
    types = "Deposit,Withdrawal"
    statuses = "Completed,Failed"
    wallet_ids = (
        "f47ac10b-58cc-4372-a567-0e02b2c3d479,1ddca562-8434-41c9-8809-d437bad9c868"
    )
    chain_ids = "BTC,ETH"
    token_ids = "ETH_USDT,ETH_USDC"
    asset_ids = "USDT,USDC"
    vault_id = "f47ac10b-58cc-4372-a567-0e02b2c3d479"
    wallet_type = cobo_waas2.WalletType("Custodial")
    wallet_subtype = cobo_waas2.WalletSubtype("Asset")
    project_id = "f47ac10b-58cc-4372-a567-0e02b2c3d479"
    min_created_timestamp = 1635744000000
    max_created_timestamp = 1635744000000
    limit = 10
    before = "RqeEoTkgKG5rpzqYzg2Hd3szmPoj2cE7w5jWwShz3C1vyGmk1"
    after = "RqeEoTkgKG5rpzqYzg2Hd3szmPoj2cE7w5jWwShz3C1vyGSAk"
    direction = "ASC"

    try:
        # List all transactions
        api_response = api_instance.list_transactions(
            request_id=request_id,
            cobo_ids=cobo_ids,
            transaction_ids=transaction_ids,
            transaction_hashes=transaction_hashes,
            types=types,
            statuses=statuses,
            wallet_ids=wallet_ids,
            chain_ids=chain_ids,
            token_ids=token_ids,
            asset_ids=asset_ids,
            vault_id=vault_id,
            wallet_type=wallet_type,
            wallet_subtype=wallet_subtype,
            project_id=project_id,
            min_created_timestamp=min_created_timestamp,
            max_created_timestamp=max_created_timestamp,
            limit=limit,
            before=before,
            after=after,
            direction=direction,
        )
        print("The response of TransactionsApi->list_transactions:\n")
        pprint(api_response)
    except Exception as e:
        print("Exception when calling TransactionsApi->list_transactions: %s\n" % e)

Authorizations

​
BIZ-API-KEY
string
header
required

The API key. For more details, refer to API key.

In the API playground, enter your API secret, and your API key will be accordingly calculated.

Query Parameters

​
request_id
string

The request ID that is used to track a transaction request. The request ID is provided by you and must be unique within your organization.

​
cobo_ids
string

A list of Cobo IDs, separated by comma. A Cobo ID can be used to track a transaction.

​
transaction_ids
string

A list of transaction IDs, separated by comma.

​
transaction_hashes
string

A list of transaction hashes, separated by comma.

​
types
string

A list of transaction types, separated by comma. Possible values include:

  • Deposit: A deposit transaction.
  • Withdrawal: A withdrawal transaction.
  • ContractCall: A transaction that interacts with a smart contract.
  • MessageSign: A transaction that signs a message.
  • ExternalSafeTx: A transaction to a Smart Contract Wallet (Safe{Wallet}) that requires one or multiple signatures to be executed.
  • Stake: A transaction that creates a staking request.
  • Unstake: A transaction that creates a unstaking request.
​
statuses
string

A list of transaction statuses, separated by comma. Possible values include:

  • Submitted: The transaction is submitted.
  • PendingScreening: The transaction is pending screening by Risk Control.
  • PendingAuthorization: The transaction is pending approvals.
  • PendingSignature: The transaction is pending signature.
  • Broadcasting: The transaction is being broadcast.
  • Confirming: The transaction is waiting for the required number of confirmations.
  • Completed: The transaction is completed.
  • Failed: The transaction failed.
  • Rejected: The transaction is rejected.
  • Pending: The transaction is waiting to be included in the next block of the blockchain.
​
wallet_ids
string

A list of wallet IDs, separated by comma.

​
chain_ids
string

A list of chain IDs, separated by comma. The chain ID is the unique identifier of a blockchain. You can retrieve the IDs of all the chains you can use by calling List enabled chains.

​
token_ids
string

A list of token IDs, separated by comma. The token ID is the unique identifier of a token. You can retrieve the IDs of all the tokens you can use by calling List enabled tokens.

​
asset_ids
string

(This concept applies to Exchange Wallets only) A list of asset IDs, separated by comma. An asset ID is the unique identifier of the asset held within your linked exchange account.

​
vault_id
string<uuid>

The vault ID, which you can retrieve by calling List all vaults.

​
wallet_type
enum<string>

The wallet type.

Available options:
Custodial,
MPC,
SmartContract,
Exchange
Example:

"Custodial"

​
wallet_subtype
enum<string>

The wallet subtype.

  • Asset: Custodial Wallets (Asset Wallets)

  • Web3: Custodial Wallets (Web3 Wallets)

  • Main: Exchange Wallets (Main Account)

  • Sub: Exchange Wallets (Sub Account)

  • Org-Controlled: MPC Wallets (Organization-Controlled Wallets)

  • User-Controlled: MPC Wallets (User-Controlled Wallets)

  • Safe{Wallet}: Smart Contract Wallets (Safe{Wallet})

Available options:
Asset,
Web3,
Org-Controlled,
User-Controlled,
Safe{Wallet},
Main,
Sub
Example:

"Asset"

​
project_id
string<uuid>

(This parameter is only applicable to User-Controlled Wallets.) The project ID, which you can retrieve by calling List all projects.

​
min_created_timestamp
integer

The time when the transaction was created, in Unix timestamp format, measured in milliseconds. You can use this parameter to filter transactions created on or after the specified time.

If not provided, the default value is 90 days before the current time. This default value is subject to change.

​
max_created_timestamp
integer

The time when the transaction was created, in Unix timestamp format, measured in milliseconds. You can use this parameter to filter transactions created on or before the specified time.

If not provided, the default value is the current time. This default value is subject to change.

​
limit
integer
default:10

The maximum number of objects to return. For most operations, the value range is [1, 50].

​
before
string

A cursor indicating the position before the current page. This value is generated by Cobo and returned in the response. If you are paginating forward from the beginning, you do not need to provide it on the first request. When paginating backward (to the previous page), you should pass the before value returned from the last response.

​
after
string

A cursor indicating the position after the current page. This value is generated by Cobo and returned in the response. You do not need to provide it on the first request. When paginating forward (to the next page), you should pass the after value returned from the last response.

​
direction
enum<string>
default:ASC

The sort direction. Possible values include:

  • ASC: Sort the results in ascending order.
  • DESC: Sort the results in descending order.
Available options:
ASC,
DESC

Response

The information about the transactions.

​
data
object[]
​
pagination
object

The pagination information of the returned data.