Create customer HD wallet
WaaS (Wallet-as-a-Service)
Create customer HD wallet
Creates a BIP39 HD wallet for a customer. The mnemonic is returned only on creation —
it is encrypted at rest and is not retrievable again except via /seed.
Requires API key + KYC + business account.
Plan limits enforced:
| Plan | Max customer wallets |
|---|---|
| Starter | 20 |
| Professional | 100 |
| Business | Unlimited |
| Enterprise | Unlimited |
Returns 402 if the subscription is expired. Returns 403 with
"code": "WALLET_LIMIT_EXCEEDED" if the plan cap is reached.
POST
Create customer HD wallet
Authorizations
Business API key for server-to-server integrations.
Key prefix determines the environment — no separate flag needed:
test_sk_* = sandbox/testnet, live_sk_* = production/mainnet.
Body
application/json

