Skip to content

Create Wallet

Supports DeFi wallets and Segregate Account warm wallets.

Endpoint

POST https://api.mycactus.dev/custody/v1/api/projects/{b_id}/wallets/create
POST https://api.mycactus.com/custody/v1/api/projects/{b_id}/wallets/create

Request

Path Parameters

Field Type Description

b_id
Required

String Business line ID

Body Parameters

FieldTypeDescription
wallet_type
Required
StringWallet type.
Allowed values: DEFI, HOT
number
Required
IntegerNumber of wallets to create. Allowed range: 1–10.
chain
Conditionally required
StringRequired when creating a HOT wallet. For a DeFi wallet, leaving this field empty creates an EVM-compatible wallet by default; set it to SOLANA to create a Solana DeFi wallet.
wallet_name
Optional
StringWallet name.

DeFi Wallet Request Body Example

Request Body
{
  "wallet_type": "DEFI",
  "number": 2
}

Segregate Account Warm Wallet Request Body Example

Request Body
{
  "wallet_type": "HOT",
  "chain": "STELLAR",
  "number": 2,
  "wallet_name": "Stellar Warm Wallet"
}

Response

Response Body

Field Type Description
code Integer Response code (0 = success)
message String Response message
data Object List of created wallet IDs (see data object details below)
successful Boolean Whether the request was successful

Response Example

{
  "code": 0,
  "message": "",
  "data": [
    "CHDEFI5301774343",
    "CHDEFI6665673551"
  ],
  "successful": true
}