All
FAQ
Announcements
Product documents
Changes to V5 API WebSocket subscription parameter and URL
Live trading URL Current Public addresses: wss://ws.okx.com:8443/ws/v5/public wss://wsaws.okx.com:8443/ws/v5/public Private addresses: wss://ws.okx.com:8443/ws/v5/private wss://wsaws.okx.com:8443/ws/v5/private Updated wss://ws.okx.com:8443/ws/v5/business wss://wsaws.okx.com:8443/ws/v5/business Applicable to public and private channels Table 3: Demo trading service address details Only the channels listed on Table 1 are required to switch to the new "/business" URL.Published on 24 Apr 2023Updated on 29 May 2026AnnouncementsChanges to V5 API users as OKX supports USDC index
Get order history (last 7 days) /api/v5/trade/orders-history uly - Get order history (last 3 months) /api/v5/trade/orders-history-archive uly - Get transaction details (last 3 days) /api/v5/trade/fills uly - Get transaction details (last 3 months) /api/v5/trade/fills-history uly - Get mark price /api/v5/public/mark-price uly - Get delivery/exercise history /api/v5/public/delivery-exercise-history uly - Get open interest /api/v5/public/open-interest uly - Get insurance fund /api/v5/public/insurance-fundPublished on 30 Mar 2023Updated on 29 May 2026AnnouncementsMulti-currency margin mode vs. Portfolio margin mode
Additionally, the delta position from spot assets can be included in the corresponding risk units For example, BTC spot assets in an account can be included in a BTC-USD or BTC-USDT risk unit for delta risk offsetting.Example of multi-currency margin mode vs. portfolio margin mode Note: Values are simulated using the position builder on 6th Feb 2025 Large delta neutral positions (favorable when in portfolio margin mode) Assets 10 BTC Positions BTCUSD-14Feb25 Futures: -35,000 contracts BTCUSDT PerpsPublished on 13 Apr 2023Updated on 16 June 2026Product documentationAnnouncement of historical data services scheduled maintenance
The affected Open API endpoints are: Endpoint name Endpoint path Order details GET /api/v5/trade/order (Only affects canceled and filled orders) Transaction details (last 3 days) GET /api/v5/trade/fills Transaction details (last 3 months) GET /api/v5/trade/fills-history Get bills details (last 7 days) GET /api/v5/account/bills Get bills details (last 3 months) GET /api/v5/account/bills-archive Order history (last 7 days) GET /api/v5/trade/orders-history Order history (last 3 months) GET /api/v5/tradePublished on 15 Mar 2024Updated on 29 May 2026AnnouncementsIndex components weightage adjustment FAQ
If you don't have any strategies based on index price, no action is required. If you have such strategies, the actions needed are subject to the specific strategies.Published on 14 Dec 2023Updated on 29 May 2026FAQ13Issues with some REST API endpoints
Dear Clients, We are aware of issues that occurred earlier today with some REST API endpoints, including GET/api/v5/account/balance and GET/api/v5/account/positions. The issues have been resolved and OKX will publish an incident report in due course. We sincerely apologize for any inconvenience this incident may have caused. Regards, Team OKXPublished on 27 Mar 2024Updated on 29 May 2026AnnouncementsHow do I use Merchant Coupon Code?
To redeem your coupon, follow these simple steps: Go to My Rewards > Coupons menu Select your coupon to view: The merchant coupon code Instructions for how and where to use it Terms and conditions specific to the offer Redeem: For online use: Copy and paste the code at checkout For in-store use: Show the code to the merchant staff Complete redemption as instructed by the merchantWhat are the important things to remember for Merchant Coupon Codes?Published on 19 May 2025Updated on 22 June 2026FAQ21OKX House FAQ
To place an order: Browse the available products on the OKX House and once you've confirmed on your desired items, select Add to Cart Once you’re ready to check out, select the cart checkout option and follow the prompts to complete your purchase Note: you’ll need to provide shipping information and payment details. 4. What payment methods are accepted on OKX House? OKX House only accepts cryptocurrency as a payment method.Published on 29 Nov 2024Updated on 29 May 2026FAQ22Why do I have to trade on OKX Liquid Marketplace?
Customizable strategies: Carry trades (spot vs future/perp), futures spreads (future vs future/perp), call/put spreads, calendar spreads, butterfly spreads, condors, ratio spreads, diagonal spreads, back spreads. Options/volatility strategies: collars, straddles, strangles, covered call, protective put, synthetic futures. Creation of synthetic currency pairs by going long one name and short another. For example, BTC/USDT vs AVAX/USDT booked atomically create a synthetic BTC/AVAX pair.Published on 13 Mar 2024Updated on 29 May 2026FAQ17Introduction to the platform collateralized borrowing limit
[Get balance] (https://www.okx.com/docs-v5/en/#trading-account-rest-api-get-balance) [Get sub-account trading balance] (https://www.okx.com/docs-v5/en/#sub-account-rest-api-get-sub-account-trading-balance) [Account channel] (https://www.okx.com/docs-v5/en/#trading-account-websocket-account-channel) Auto-conversion methods may vary by account mode.Published on 28 Apr 2025Updated on 29 May 2026Product documentationWhat's OKX Security Assistant?
Please prioritize “clean / uninstall” actions. Selecting “Minimize / mute / ignore”from the options doesn’t mean the risk is gone. Below are the best practices when it comes to handling risky situations: What the OKX Security Assistant displays when there's a riskSingle-item uninstall vs. one-click uninstall Single-item uninstall: suitable when there are only a few risk items and you want to confirm their sources one by one.Published on 15 Jan 2026Updated on 29 May 2026FAQ80How does futures spread trading work on OKX Liquid Marketplace?
Trade all sorts of spreads: carry trades (spot vs future/perp), futures spreads (future vs future/perp), call/put spreads, calendar spreads, butterfly spreads, condors, ratio spreads, diagonal spreads, back spreads. Bespoke instruments: customize your own strategies with up to 20 legs.Published on 13 Mar 2024Updated on 29 May 2026FAQ6OKX Enhanced Liquidity Program
GET /api/v5/market/books GET /api/v5/market/books-full WebSocket: books/books5/bbo-tbt/books-l2-tbt/books50-l2-tbt There will be a new WebSocket channel to include all ELP orders only (both valid and invalid parts). Users should distinguish valid and invalid parts using the best bid and ask price of non-ELP orders. WebSocket: books-ELP Web and app order book ELP orders will be displayed in the order books on the web and app interfaces.Published on 26 Nov 2025Updated on 29 May 2026Product documentationOKX to enable automatic updates for funding fee settlement period
Please refer to Perpetual Information or the API endpoint GET /api/v5/public/funding-rate to obtain the latest funding rate settlement frequency, and adjust your trading strategy accordingly. OKX team September 12, 2025Published on 12 Sept 2025Updated on 29 May 2026AnnouncementsOKX to adjust the minimum order quantities for several futures
API interface adjustment rules Post-adjustment, the API endpoint (/api/v5/public/instruments) and the WebSocket channel (Instruments) will reflect the updated values for step size (lotSz) and minimum order quantity (minSz). More details: https://www.okx.com/docs-v5/log_en/#upcoming-changes-lot-size-change-for-futures-contracts Risk warning: The foregoing overview and information, some of which may be provided by third parties and not OKX, are for informational and educational purposes only.Published on 16 Oct 2024Updated on 29 May 2026Announcements