Skip to main content
Sub-accounts enable creation and management of separate trading accounts under the main account. Control access with dedicated API keys, transfer funds between accounts, and monitor balances. For general API conventions (base URL, error format, rate limits), see the API Reference Overview.

​
Who uses this

Sub-accounts back the partner-operated integration model — see Integration models for the full comparison:
  • Model A — partner-operated sub-accounts. The partner creates and manages one sub-account per end user under the master account and holds the sub-account API key. This is the account-operator and managed-trading-platform pattern, and the endpoints below implement it. See Embedded Trading sub-account integration.
  • Model B — customers’ own accounts (contrast). The end user keeps a standalone WhiteBIT account and the partner connects through a Fast API Key; sub-accounts are not used. Listed here so the choice between the two models is explicit.

​
Account Management

Create Sub-Account

Create a new sub-account

Delete Sub-Account

Delete a sub-account

Edit Sub-Account

Edit sub-account details

List of Sub-Accounts

Get list of all sub-accounts

Block Sub-Account

Block a sub-account

Unblock Sub-Account

Unblock a sub-account

​
Balance & Transfers

Sub-Account Transfer

Transfer funds to/from sub-account

Sub-Account Balances

Get sub-account balances

Get Sub-Account Transfer History

Get sub-account transfer history

​
Withdrawals

List Unconfirmed Sub-Account Withdrawals

List sub-account withdrawals awaiting main account confirmation

Confirm Sub-Account Withdrawal

Approve a pending sub-account withdrawal by transaction id

​
API Key Management

Create Sub-Account API Key

Create API key for sub-account

Edit Sub-Account API Key

Edit sub-account API key

Delete Sub-Account API Key

Delete sub-account API key

List Sub-Account API Keys

List all sub-account API keys

Reset Sub-Account API Key

Reset sub-account API key

List Sub-Account API Key IP Addresses

List IP addresses for API key

Create Sub-Account API Key IP Address

Add IP address to API key whitelist

Delete Sub-Account API Key IP Address

Remove IP address from API key whitelist