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 Jun 2026Product documentationOKX to support Lisk mainnet upgrade
For more details on the network upgrade, please visit: https://lisk.com/blog/posts/announcing-lisk-mainnet-v4-migration. OKX team December 5, 2023Published on 5 Dec 2023Updated on 29 May 2026AnnouncementsAnnouncement 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 29 May 2026FAQ21How to set up an OKX Signal Trading bot with TradingView
Alternatively, these are also known as study scripts and not indicators in PineScript™ v4. For users employing indicators/study scripts and third-party programs, skip ahead to Step 3.2, Step 3.3 and Step 3.4 based on your specific use case.Published on 30 Aug 2023Updated on 29 May 2026Product documentationWhy 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 2026FAQ17What's Nitro Spreads and how can I trade on OKX Nitro Spreads?
Currently, we support: Spot vs Perpetual, Spot vs Futures, Perpetual vs Futures, and Futures vs Futures. Futures for now include Bi-Quarterly Futures and Quarterly Futures.3. How do I interpret the bid and ask prices on the spread tiles? The prices on the tiles indicate the spread between the filled prices of the two instruments after the trade is filled. The spread will be equal to the filled price of the further dated instrument minus the nearer dated instrument.Published on 25 Sept 2023Updated on 29 May 2026FAQ35Introduction 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 2026FAQ77Open API for ETH Staking
API documentation link:https://www.okx.com/docs-v5/en/#financial-product-eth-staking We'll continue working to provide you with better products and services. Sincerely, The OKX team November 08, 2023 (UTC)Published on 9 Nov 2023Updated on 29 May 2026AnnouncementsHow 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 2026FAQ6