Latest API Updates (May 2025)
New Bill History Endpoints now available in live trading environment:
- Apply for bill details (since 2021)
- Retrieve bill details (since 2021)
April 2025 Enhancements
Sub-Account Management
New sub-account endpoints:
- Create sub-account
- Generate API keys for sub-accounts
- Query sub-account API keys
- Delete sub-account API keys
Error Code Updates
| Error Code | Message |
|---|---|
| 59515 | Your account isn't whitelisted for custody services. Contact support. |
| 59516 | Create Copper custody account first |
| 59517 | Create Komainu custody account first |
| 59518 | Sub-account creation via API disabled. Use web/App interface. |
| 59519 | Feature frozen: {freezereason} |
👉 Explore OKX's sub-account management solutions
February 2025 Feature Additions
Balance Tracking Improvements
New return parameters across multiple endpoints:
- Account balance checks
- Sub-account trading balances
- Account channel updates
| Parameter | Type | Description |
|---|---|---|
| notionalUsdForBorrow | String | Borrowed amount (USD value) |
| notionalUsdForSwap | String | Perpetual swap position value |
| notionalUsdForFutures | String | Futures position value |
| notionalUsdForOption | String | Options position value |
January 2025 Compliance Updates
EEA Withdrawal Requirements
European Economic Area users must include rcvrInfo for:
- Blockchain withdrawals
- Lightning Network withdrawals
| Parameter | Required | Description |
|---|---|---|
| walletType | Yes | exchange for institutional wallets |
| exchId | Optional | Supported exchange ID (query via public endpoint) |
| rcvrFirstName | Conditional | Receiver's first name/company name |
| rcvrLastName | Conditional | Receiver's last name ("N/A" for companies) |
Withdrawal Restrictions
- Private wallet withdrawals via API are prohibited (use OKX App/website)
- New withdrawal record parameters:
| Parameter | Description |
|---|---|
| note | Additional remarks |
New Error Codes
| Code | Message |
|---|---|
| 58239 | Private wallet withdrawals require OKX App/website |
December 2024 Updates
(No significant changes recorded)
September 2024 Improvements
Account Configuration
- New parameters for spot trading:
| Parameter | Description |
|---|---|
| enableSpotBorrow | Spot mode borrowing support |
| spotBorrowAutoRepay | Auto-repayment feature |
Leverage Adjustments
- Added currency parameter (
ccy) to leverage queries
Strategy Order Enhancements
New parameter across multiple algo-trading endpoints:
| Parameter | Description |
|---|---|
| isTradeBorrowMode | Auto-borrow toggle for TWAP/stop orders |
👉 Discover advanced trading strategies on OKX
FAQ Section
Q: Can I create sub-accounts via API?
A: As of April 2025, sub-account creation requires using the web/App interface (error code 59518).
Q: What's required for EEA withdrawals?
A: European users must provide receiver information (rcvrInfo) when withdrawing to exchange wallets.
Q: How do I check borrowing availability?
A: The enableSpotBorrow parameter in account configuration indicates borrowing support.
Q: Where can I find supported exchanges for withdrawals?
A: Use the Get Exchange List endpoint.
Q: Why can't I withdraw to private wallets via API?
A: Compliance measures require private wallet withdrawals through official OKX interfaces (App/website).