Skip to main content
Create and manage separate trading accounts under one umbrella — each with independent balances, API keys, and IP whitelists. 20 API endpoints cover the full lifecycle from account creation to withdrawal approval.

Capabilities

The Sub-Accounts API provides full programmatic control over multi-account architectures.
  • Account CRUD — create, edit, delete, and list sub-accounts. Each sub-account gets a unique identifier and independent settings. A main account holds up to 50 sub-accounts by default; the assigned account manager raises the limit on request.
  • Fee-free transfers — move assets between the main account and the Main balance of any sub-account without fees via POST /api/v4/sub-account/transfer
  • Per-sub-account API keys — generate dedicated API keys for each sub-account with independent IP whitelists (up to 50 IPs per key). The 50-key limit applies per sub-account, independent from the main account and from other sub-accounts. Supports create, edit, delete, reset, and IP management. The 14-day deactivation of unused keys applies to sub-account keys too: an unused key is disabled, not deleted, and Reset Sub-Account API Key switches it back on with the same key, secret, enabled URLs, and IP whitelist.
  • KYC URL generation — generate temporary KYC verification links for sub-account users via POST /api/v4/sub-account/kyc-url. Requirements: sub-account must be activated (the end user has opened the WhiteBIT invitation email and set a password, and List of Sub-Accounts shows status active), not blocked, and not using shared KYC.
  • Withdrawal approval flow — list pending sub-account withdrawals via POST /api/v4/sub-account/withdraw/unconfirmed-list, then approve each one via POST /api/v4/sub-account/withdraw/confirm. Not available by default — request access through the assigned account manager.
  • Direct crypto deposits — once enabled for the account, sub-accounts receive crypto directly at dedicated deposit addresses, generated via the standard deposit-address endpoint using the sub-account’s own API key. Disabled by default (see note below). Every URL group starts switched off on a new sub-account key, so enable /api/v4/main-account/address on a type: 2 key with Edit Sub-Account API Key before generating addresses.

Who Uses This

  • Fund managers and asset managers — separate client funds into isolated sub-accounts. Independent API keys per strategy or client. Fee-free transfers for rebalancing. (Institutional sub-accounts)
  • Account operators and trading platforms — onboard end users as sub-accounts under Embedded Trading. Earn up to 40% of trading fees generated by referred users. Manage API keys centrally.
  • Prop trading firms — isolate trading strategies with separate risk profiles. Per-account balance monitoring. Independent position tracking.
  • Wallet and yield services — run each end user’s wallet (Wallet-as-a-Service) or Crypto Lending (Yield-as-a-Service) in a sub-account per end user.

Common Integration Patterns

Fund / Asset Manager — Create a sub-account per client or investment strategy. Generate independent API keys for each, allowing automated trading without exposing the main account. Transfer funds fee-free between the main account and sub-accounts for rebalancing. Monitor balances across all sub-accounts via POST /api/v4/sub-account/balances. List transfer requests via POST /api/v4/sub-account/transfer/history, and confirm that each transfer settled on the sub-account balances. (Source: institutional.whitebit.com/sub-accounts) Account operator / Agency — Apply to Embedded Trading (contact institutional@whitebit.com). Create sub-accounts for each end user. Generate KYC URLs for customer verification. Earn up to 40% of the trading fee generated by referred users; the applicable rate is agreed during enrollment. Manage all sub-account API keys from the main account.
EUR/SEPA operations for account operators: Fiat deposit and withdrawal functionality requires separate institutional onboarding through WhiteBIT and a fiat processing partner. See the Onboarding Guide for the full process.
Crypto deposits to sub-accounts are disabled by default. Enablement for the account is not available via API. To request it, contact the assigned account manager. Each sub-account also needs its own deposit permission, depositsEnabled, and withdrawal permission, withdrawsEnabled: set with Create Sub-Account for a sub-account created without an email, otherwise with Edit Sub-Account after activation.
Prop Trading Firm — Create isolated sub-accounts per trading strategy or desk. Assign different risk budgets by controlling the balance in each sub-account. Use per-sub-account API keys to run independent trading bots — traders, risk managers, operations, and finance teams can each have separately permissioned access. Block or unblock sub-accounts via API to enforce risk controls. (Source: institutional.whitebit.com/sub-accounts) A block refuses every request signed with the sub-account’s API keys (401, This user is blocked), and a block on the main account does the same for the keys of all its sub-accounts. A block does not cancel the sub-account’s open orders or pending withdrawals, and after the block a cancel request signed with the sub-account’s key is refused too, so a risk-control bot cancels any order that must not fill before sending the block; see Block Sub-Account.

Technical Overview

  • 20 endpoints (all POST, all authenticated)
  • Endpoint groups: account management (4), transfers (2), blocking (2), balances (1), withdrawals (2), API key management (5), IP whitelist management (3), KYC (1)
  • Authentication: HMAC-SHA512 (guide)
  • Rate limits: 1000 requests per 10 seconds per endpoint (details)
  • Availability: the withdrawal endpoints are not available by default; request access through the assigned account manager
For full endpoint documentation, see the Sub-Accounts API Reference.

What’s Next

Quickstart

Create a sub-account and transfer funds in under 5 minutes.

API Reference

Full endpoint documentation for all 20 sub-account endpoints.

Sub-account integration

End-to-end integration guide for Embedded Trading.