Understanding OKX Account Structure
OKX's account system consists of master accounts and sub-accounts. A single master account can create multiple sub-accounts, which function as subordinate accounts under the primary account.
Key Features of Sub-Accounts:
- Independent Credentials: Each sub-account has unique login details
- Asset Segregation: Funds can be allocated from master to sub-accounts
- Trading Capabilities: Supports spot, margin, futures, and options trading
- No Withdrawals: Funds must be transferred back to master account for withdrawal
Asset Transfer Between Accounts
Use the following API endpoints for account management:
Transfer Endpoint
POST /api/account/v3/transfer
Enables fund movement between:
- Master account → Sub-account (all account types)
- Sub-account → Master account (funding account only)
Sub-Account Balance Query
GET /api/account/v3/sub-account
Retrieves sub-account balances including:
- Available funds
- Frozen assets
- Account limits
Account Comparison Tables
Master vs. Sub-Accounts
| Feature | Master Account | Sub-Account |
|---|---|---|
| Fund Transfers | Yes | Yes* |
| Trading | Yes | Yes |
| Independent Login | Yes | Yes |
| Rate Limits | Independent | Independent |
| Fee Structure | Custom | Inherited |
| KYC Information | Required | Inherited |
*Sub-account transfers restricted as described
Account Type Capabilities
| Account Type | Transfers | Trading | API Support |
|---|---|---|---|
| Funding Account | Yes | No | Yes |
| Spot Trading | Yes | Yes | Yes |
| Margin Trading | Yes | Yes | Yes |
| Futures Contracts | Yes | Yes | Yes |
| Perpetual Contracts | Yes | Yes | Yes |
| Options Contracts | Yes | Yes | Yes |
Best Practices for Account Management
- Security First: Always use API keys with appropriate permissions
- Asset Allocation: Distribute funds strategically between accounts
- Rate Limit Awareness: Monitor request frequencies across accounts
- Fee Optimization: Leverage shared fee tiers between master/sub-accounts
👉 Explore advanced trading strategies with OKX API
FAQ Section
Q: How many sub-accounts can I create under a master account?
A: OKX allows creation of multiple sub-accounts per master account, with exact limits depending on your verification level.
Q: Can sub-accounts have different trading permissions?
A: Yes, master accounts can set specific trading permissions for each sub-account through the account management interface.
Q: Are there fees for transfers between master and sub-accounts?
A: Internal transfers between OKX accounts typically don't incur fees, but always check current platform policies.
Q: How often can I transfer funds between accounts?
A: Transfer frequency limits may apply depending on your account security settings and verification status.
Q: Can I automate transfers between accounts using API?
A: Yes, the transfer API endpoint supports programmatic asset movement between qualified accounts.