Skip to main content
This changelog details all additions and changes to the WaaS 2.0 API. You can download the WaaS 2.0 API specification from GitHub. For changes specific to payment-related operations, please refer to the Release history of the payment solution.

​
v1.24.0

This version was released on October 15, 2025.

​
New Features

  • You can now check whether Fee Station is applicable for a transaction by using the Check Fee Station usage operation.

​
Improvements

  • Removed the BTC_EIP_191_Signature and Raw_Message_Signature schemas from the Sign Message operation.
  • Added the STELLAR_Contract schema in the Call smart contract operation to support trustline management on the Stellar network.
  • Added a new schema SolContractCallAddressLookupTableAccount to support using Solana Address Lookup Tables.
  • Added the main_transaction_id property to indicate the main transaction in the FuelingInfo schema.

​
v1.23.0

This version was released on September 17, 2025.

​
Breaking Changes

  • Updated the response schema of List approval details. Several properties were added or modified.
  • Updated the behavior of the List Address Book Entries operation:
    • When both address and label are provided, results are now returned only if both match (previously matched if either condition was true).
    • The chain_id parameter has been changed from required to optional.

​
New Features

​
Improvements

  • Added a property chain_identifier to the chain schema which groups chains by their execution logic. For example, ETH for all EVM-compatible chains (Ethereum, BNB Smart Chain, Polygon).
  • Added a property biz_org_id to the response schema of Get organization information which can be provided to Cobo’s customer support to help quickly locate the organization.

​
v1.22.0

This version was released on August 27, 2025.

​
New Features

​
Improvements

  • You can enable auto token sweeping for MPC Wallets and Web3 Wallets by setting the enable_auto_sweep parameter to true when using the Creating wallet operation.

​
v1.21.0

This version was released on August 13, 2025.

​
New Features

​
Improvements

  • Added compliance-related enums to the TransactionCoboCategory schema:
    • ScreenAppRefund
    • ScreenAppIsolate
    • ComplianceRefund
    • ComplianceIsolate

​
v1.20.0

This version was released on July 30, 2025.

​
Improvements

  • Added UsePortalPreference as a new option to the AutoFuelType enum for Fee Station transactions. This option allows you to use payment preferences set on Cobo Portal instead of specifying the mode of transaction fee payment in each API call.
  • The destination property in the Estimate transaction fee request for contract calls is now optional.
  • Added a maximum length limit of 65,000 characters for the calldata field in the Call smart contract operation (EVM contract calls).

​
v1.19.1

This version was released on July 17, 2025.

​
Improvements

  • Added support for the Solana and Filecoin fee models when creating transactions and retrieving transaction information. For more details, refer to the Fee models guide.
  • Introduced new webhook event types for token or chain status changes
    • wallet.token.disabled
    • wallet.chain.disabled
    • token.suspended.deposit
    • token.suspended.withdraw
  • Added a new transaction sub-status, RejectedByCobo, to indicate transactions rejected due to unmet compliance requirements.

​
v1.18.0

This version was released on July 2, 2025.

​
New Features

​
Improvements

  • Enhanced the List enabled tokens operation to support filtering by specific token IDs.
  • Introduced new webhook event types for more granular and real-time balance update notifications:
    • wallets.mpc.balance.updated
    • wallets.web3.balance.updated

​
v1.17.0

This version was released on June 18, 2025.

​
New Features

​
Improvements

The Transfer token operation now supports Custodial Wallet (Asset Wallet) transfers using a wallet ID. This feature requires whitelist access. You can contact help@cobo.com to request enrollment. Please note that implementing this feature may require updates to your existing transaction history data handling.

​
v1.16.0

This version was released on May 28, 2025.

​
New Features

​
Improvements

  • Enhanced the Estimate transaction fee operation by adding a property replaced_transaction_id to the request body, allowing fee estimation for replacement transactions.
  • Added new values to the TransactionCoboCategory schema to support more use cases.
  • Added a property coinbase_maturity to the ChainInfo schema to indicate the required confirmations for coinbase maturity.
  • Added two transaction sub-statuses PendingCoboKYTCheck and RejectedByCoboKYT.
  • Added the is_frozen property to the response of the List UTXOs operation. This property indicates whether each UTXO is currently frozen and unavailable for spending.

​
v1.15.0

This version was released on May 14, 2025.

​
Improvements

  • Added the following new transaction sub-statuses to support more granular tracking in transaction screening scenarios:
    • PendingCoboCheck
    • RejectedTransactionPolicy
    • RejectedByScreeningApp
    • PendingScreeningAppCheck
  • Added the estimated_fee_used property to the schemas TransactionEvmEip1559Fee, TransactionEvmLegacyFee, TransactionUtxoFee, and TransactionFixedFee for MPC Wallets and Custodial Wallets (Web3 Wallets) transactions, to indicate the estimated transaction fee when retrieving transaction information.
  • Added the query parameters wallet_type and wallet_subtype to the List all transactions operation, allowing you to filter transactions by wallet classification.
  • Added the properties wallet_subtype and encoding to the response of the List address book entries operation, providing more context for address usage.
  • Added data structures for TSS request events and callback payloads.

​
v1.14.0

This version was released on April 23, 2025.

​
New Features

​
Improvements

  • Added new webhook event types to support more real-time updates:
    • wallets.token_listing.failed
    • wallets.token_listing.succeeded
    • payment.transaction.created
    • payment.transaction.late
    • payment.transaction.held
    • payment.status.updated
    • payment.refund.status.updated
    • payment.settlement.status.updated
  • Added new fields wallet_type and wallet_sub_type to the wallet.token.enabled and wallet.chain.enabled webhook events to indicate supported wallet types and sub-types.
  • Enhanced the List Fee Station token balances operation by adding the chain_id field to the response.
  • Enhanced the List all transactions operation. By default, it now returns transactions from the past 90 days if min_created_timestamp and max_created_timestamp are not specified.

​
v1.13.0

This version was released on April 9, 2025.

​
Breaking Changes

  • The name property is now required in the Update wallet operation.
  • The AddressEncoding field now returns ENCODING_DEFAULT instead of an empty string ("") as the default value.

​
Improvements

  • Added a new schema CustodialWeb3TransferSource to support Replace-By-Fee (RBF) transactions from Custodial Wallets (Web3 Wallets). You can now initiate RBF transactions from Custodial Wallets (Web3 Wallets) using the Drop transaction and Speed up transaction operations.
  • Added the following new transaction sub-statuses to provide more granular tracking of transaction progress:
    • PendingSignerApproval
    • PendingSignerProcessing
    • RejectedBySigner
    • FailedSignerTimeout
    • InsufficientBalance
    • InsufficientBalanceFundLocked
    • PendingSystemProcessing
    • SystemProcessingOngoing
    • ReOrged
  • Added new schemas TransactionBIP137Destination, TransactionBIP322Destination, TransactionCosmosAdr36Destination, and TransactionMessageSignBTCEIP191Destination. You can now sign messages and view transactions using these destination types.
  • Extended the AddressEncoding schema with new enum values ENCODING_ADA_BYRON, ENCODING_ADA_SHELLEY, and ENCODING_DEFAULT to support a wider range of address encoding formats.
  • Introduced a new extra property in the Transaction schema to carry structured, extensible, and business-specific information. This field is returned as a JSON-encoded string.
  • Removed the properties param_version, withdraw_from_type, slash_from_type, and stake_amount from the BabylonStakingActivityDetailExtra schema.

​
v1.12.0

This version was released on March 27, 2025.

​
New Features

Now you can query Fee Station information with the following operations: Additionally, we’ve introduced a new operation to update wallet balances:

​
Improvements

  • Added support for Custodial Wallets (Web3 Wallets) across key transaction operations.
  • Added new webhook event types wallet.token.enabled and wallet.chain.enabled, along with new data types Tokens and Chains. For more details, refer to Webhook event types and data types.
  • Extended schema properties:
    • TransactionMessageSignEIP712Destination: Added safe_tx_extra_data and raw_structured_data for enhanced Safe transaction context
    • BabylonStakingActivityDetailExtra: Added withdraw_from_type and slash_from_type for improved Babylon staking activity information
    • Transaction: Added cobo_category for Cobo-defined transaction categorization
    • TransactionSelectedUtxo: Added redeem_script and revealed_script for detailed UTXO transaction information
  • Optimized TransactionUtxoFee schema by making fee_rate an optional field
  • The List all transactions operation now supports sorting by direction.

​
v1.11.0

This version was released on March 12, 2025.

​
Improvements

  • Added support for Solana (SOL) contracts in the Call smart contract operation.
  • Added the reserved_fee property to the response of the Estimate transaction fee operation for both EIP-1559 and legacy fee models, which represents the estimated fee for submitting transaction calldata to L1 (Layer 1).

​
v1.10.0

This version was released on March 3, 2025.

​
New Features

Now you can initiate and track registration for Babylon airdrop and Babylon Phase-2 with the following operations:

​
Improvements

  • Added a utxo_change property with UTXO change information to the TransactionRawTxInfo schema.
  • Added 3 enum values BitHive, BERABeacon, and BeraChainBGT to the StakingPoolType schema.
  • Added 6 enum values bithive_signet, bithive, beacon_bera, beacon_bera_testnet, berachain_bgt, and berachain_bgt_testnet to the StakingPoolId schema.
  • Added a property wallet_id to the AddressesEventData schema.
  • Added a property mpc_used_key_share_holder_group to the MpcContractCallSource, MpcMessageSignSource, and MpcTransferSource schemas to indicate which key share holder group is used for this transaction.

​
v1.9.0

This version was released on February 19, 2025.

​
New Features

  • Added List address balances by token operation for MPC Wallets to retrieve token balances across multiple addresses.
  • Enhanced MPC Wallet key share holder management with new operations:
  • Added the Sign and broadcast transaction operation, along with the Built transaction sub-status and the unsigned_raw_tx property in the raw_tx_info object of the Transaction schema, to manually sign and broadcast transactions that were built without being executed automatically.

​
Improvements

  • Enhanced the List UTXOs operation with a new tx_hash query parameter, enabling UTXO lookup by transaction hash.
  • Enhanced the Sign message operation to support raw message and BTC EIP-191 signature.
  • Enhanced the Create addresses in wallet operation to enable generating tweaked addresses.
  • Enhanced the Transfer token operation by adding a new property change_output_type to the AddressTransferDestination schema.
  • Added a tx_info property to the TransactionDepositToAddressDestination schema, including vout_n index information.

​
v1.8.0

This version was released on January 8, 2025.

​
New Features

​
Improvements

  • Added new webhook event types wallets.addresses.created, wallets.created, and mpc_vaults.created and new event data types Addresses, WalletInfo, and MPCVault to optimize the processing of webhook events.
  • Made several improvements to staking operations:
    • Added the BabylonStakingActivityDetailExtra, EthStakingActivityDetailExtra, and CoreStakingActivityDetailExtra schemas to represent the extra details for each staking protocol.
    • Added the request_id query parameter for the List staking activities operation to filter activities based on a specific request ID.
    • Made the extra property optional in the CreateStakeActivity schema.
  • Added the root_pubkey property to the AddressInfo schema to indicate the root extended public key of the address.
  • Added the TransactionSelectedUtxo schema to represent the selected UTXO information in a transaction.

​
v1.7.0

This version was released on December 19, 2024.

​
Breaking Changes

  • Renamed create_timestamp to created_timestamp in the MPCProject schema to improve consistency in naming conventions.

​
New features

​
Improvements

  • Made several fields optional in the BabylonValidator schema.
  • Extended ETH staking functionality by adding the beacon_validators property to the EthStakingExtra schema to represent the list of validator information.
  • Improved the StakingPoolId schema by making it an enum type.
  • Extended the ActivityAction schema with additional enums to cover more actions that can occur during a staking activity.
  • Deprecated the original version of the “Estimate staking fees” operation.

​
v1.6.0

This version was released on November 13, 2024.

​
Breaking changes

  • Removed the “Get address information” operation.
  • Made amount a required property in the AddressTransferDestination schema.

​
New features

​
Improvements

  • Made the following properties optional:
    • request_id and destination in EstimateTransferFeeParams
    • request_id in EstimateContractCallFeeParams
  • Removed the script property from:
    • TransactionTransferToAddressDestination
    • AddressTransferDestination

​
v1.5.0

This version was released on October 24, 2024.

​
Breaking Changes

In this release, the following parameter names in the Python SDK have been updated:
  • ORG_MINUS_CONTROLLED → ORG_CONTROLLED
  • USER_MINUS_CONTROLLED → USER_CONTROLLED
  • SAFE_LEFT_CURLY_BRACKET_WALLET_RIGHT_CURLY_BRACKET → SAFE_WALLET
Please update your code to reflect these changes, as previous parameter names are no longer supported.

​
New features

​
Improvements

  • Added the asset_model_type property in the response of the Get token information operation to indicate whether a token uses the account model or the UTXO model.
  • Added the calldata_info property to the TransactionEvmContractDestination schema to provide a more detailed representation of smart contract calldata.
  • Added the TransactionRawMessageSignDestination schema and added the Raw_Message_Signature value to the destination_type enum to represent the transaction destination for raw message signatures.
  • Added Stake and Unstake as new possible values for the types query parameter in the List all transactions operation.
  • Added bitmart and bitfinex as new possible values to the exchange_id enum.
  • The delegate property is no longer a required property in the TransactionSmartContractSafeWalletSource schema.

​
v1.4.0

This version was released on September 25, 2024.

​
Improvements

  • Improved the tracking of transactions by adding and removing certain statuses and sub-statuses in the TransactionStatus and TransactionSubStatus schemas.
  • Added the MPCProcessing status in the TSSRequestStatus schema to indicate that the TSS request approval is waiting to be started.
  • Removed the nonce property in the MpcContractCallSource schema.

​
v1.3.0

This version was released on September 12, 2024.

​
New features

​
Improvements

  • Changed the path of the Check Cobo Loop transfers operation from /wallets/check_loop_transfers to /transactions/check_loop_transfers.
  • Added the dust_threshold and custodial_minimum_deposit_threshold properties in the TokenInfo schema to indicate the minimum withdrawal and deposit amounts for Custodial Wallets.
  • Added the confirming_threshold property in the ChainInfo schema to indicate the number of confirmations required for a transaction on each chain.

​
Bug fixes

  • Fixed an issue with using WaaS SDKs to perform operations relating to contract call or message signing.

​
v1.2.0

This version was released on August 21, 2024.

​
New features

​
Improvements

  • The sub_wallet_id property was renamed as trading_account_type. Affected schemas include:
    • ExchangeTransferSource
    • ExchangeTransferDestination
    • TransactionTransferToWalletDestination
    • TransactionExchangeWalletSource
    • TransactionDepositFromWalletSource
    • TransactionDepositToWalletDestination
  • Added the PendingApprovalStart enum value in the TransactionSubStatus enum to indicate a status that requires specific action from users for proceeding with the transaction.
  • Added the project_name and vault_name properties in the MPCWalletInfo schema to indicate the project name and vault name.
  • Added the description and created_timestamp properties in the TSSRequest schema to indicate the description and creation time of the TSS request.
  • Added the account_id property in the KeyShareHolder schema to indicate the key share holder’s account ID on Cobo Portal.
  • Added the signer_key_share_holder_group_id property in the TransactionMPCWalletSource schema to indicate the ID of the key share holder group as the transaction signer.
  • Added the description property in the request body of Create TSS request to indicate the description of the TSS request.

​
v1.1.0

This version was released on August 7, 2024.

​
New features

Added OAuth operations for Cobo Portal App developers:

​
Improvements

  • The data type of data.response_body was updated from object to string in the response of List webhook event logs.
  • Added the signer property to indicate whether the key share holder’s TSS Node is a designated transaction signer. Affected schemas include:
    • CreateKeyShareHolder
    • KeyShareHolder
  • The node_count property was renamed as participants in:
  • The pubkey property was renamed as root_pubkey in the RootPubkey schema.
  • Added the root_pubkey property to indicate the vault’s root extended public key in the TSSGroups schema.
  • Several timestamp-related properties were renamed using the “_timestamp” suffix. Affected schemas include:
    • Transaction
    • TransactionBlockInfo
    • TransactionTimeline
    • KeyShareHolderGroup
    • MPCVault

​
v1.0.0

This is the first release of the Cobo WaaS 2.0 API. This release includes support for Custodial Wallets and MPC Wallets, with the following categories of operations:
Feel free to share your feedback to improve our documentation!