Skip to main content
POST
/
wallets
curl --request POST \
  --url http://localhost:4000/v1/wallets \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "walletName": "My Treasury Wallet"
}
'
{
  "success": true,
  "message": "<string>",
  "statusCode": 123,
  "timestamp": "<string>",
  "data": {
    "walletId": "wallet-abc123def456",
    "walletName": "My Treasury Wallet",
    "addresses": [
      {
        "address": "0x123abc456def789012345678901234567890abcd",
        "path": "m/44'/60'/0'/0/0",
        "addressFormat": "ADDRESS_FORMAT_ETHEREUM"
      }
    ],
    "subOrganizationId": "suborg-xyz789"
  },
  "path": "<string>"
}

Authorizations

​
Authorization
string
header
required

Use this format: ApiKey <your_api_key>

Query Parameters

​
integratorId
string

Integrator ID (required for ADMIN/INTERNAL scope)

Example:

"uuid-integrator-id"

Body

application/json

Wallet creation parameters. Only walletName is required. If neither accounts nor addressFormats are provided, defaults to creating an Ethereum wallet with 12-word mnemonic. Example minimal request: { "walletName": "My Wallet" }

​
walletName
string
required

Human-readable name for the wallet

Example:

"My Treasury Wallet"

​
accounts
object[]

Array of account parameters to create in the wallet

Example:
[
  {
    "curve": "CURVE_SECP256K1",
    "pathFormat": "PATH_FORMAT_BIP32",
    "path": "m/44'/60'/0'/0/0",
    "addressFormat": "ADDRESS_FORMAT_ETHEREUM"
  }
]
​
addressFormats
enum<string>[]

Array of address formats to create (simplified, auto-derives paths). Defaults to [ADDRESS_FORMAT_ETHEREUM] if neither accounts nor addressFormats are provided.

Available options:
ADDRESS_FORMAT_ETHEREUM,
ADDRESS_FORMAT_COMPRESSED,
ADDRESS_FORMAT_SOLANA
Example:
[
  "ADDRESS_FORMAT_ETHEREUM",
  "ADDRESS_FORMAT_SOLANA"
]
​
mnemonicLength
number

Mnemonic length for the wallet seed phrase (12 or 24). Defaults to 12 if not provided.

Required range: 12 <= x <= 24
Example:

12

Response

​
success
boolean
required
​
message
string
required
​
statusCode
number
required
​
timestamp
string
required
​
data
object
​
path
string