Skip to main content
POST
Try Cobo WaaS Skill in your AI coding assistant (Claude Code, Cursor, etc.). Describe your needs in natural language to auto-generate production-ready SDK code and debug faster 🚀

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.

Body

application/json

The request body to create a wallet

The information of Custodial Wallets.

name
string
required

The wallet name. This field is required and cannot be empty. Letters, numbers, and spaces are supported (for example, My WaaS 2.0 Wallet).

Some special characters are not accepted. For example, the at sign (@) is rejected. If the name is empty or contains unsupported characters, the request fails with a 400 Bad Request error.

Example:

"My WaaS 2.0 Wallet"

wallet_type
enum<string>
required

The wallet type. Possible values include:

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

"Custodial"

wallet_subtype
enum<string>
required

The wallet sub-type. Possible values include:

  • Asset: Custodial Wallets (Asset Wallets).
  • Web3: Custodial Wallets (Web3 Wallets).
  • Org-Controlled: MPC Wallets (Organization-Controlled Wallets).
  • User-Controlled: MPC Wallets (User-Controlled Wallets).
  • Safe{Wallet}: Smart Contract Wallets (Safe).
  • Main: Exchange Wallets (Main Account).
  • Sub: Exchange Wallets (Sub Account).

Each wallet sub-type requires a different set of properties. Switch between the above tabs for details.

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

"Asset"

enable_auto_sweep
boolean

Enable the auto-sweep feature for the wallet. This parameter only applies to MPC Wallets and Custodial Wallets (Web3 Wallets).

Response

The request was successful.

The basic information of a wallet.

wallet_id
string<uuid>
required

The wallet ID.

Example:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"

wallet_type
enum<string>
required

The wallet type. Possible values include:

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

"Custodial"

wallet_subtype
enum<string>
required

The wallet sub-type. Possible values include:

  • Asset: Custodial Wallets (Asset Wallets).
  • Web3: Custodial Wallets (Web3 Wallets).
  • Org-Controlled: MPC Wallets (Organization-Controlled Wallets).
  • User-Controlled: MPC Wallets (User-Controlled Wallets).
  • Safe{Wallet}: Smart Contract Wallets (Safe).
  • Main: Exchange Wallets (Main Account).
  • Sub: Exchange Wallets (Sub Account).

Each wallet sub-type requires a different set of properties. Switch between the above tabs for details.

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

"Asset"

name
string
required

The wallet name.

Example:

"Example Wallet"

org_id
string
required

The ID of the owning organization.

Example:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"

enable_auto_sweep
boolean

Enable the auto sweep feature for the wallet