All
FAQ
Announcements
Product documents
What's mark price vs last price vs index price?
X-Perps trading uses multiple price references. Understanding the difference is important because different functions may rely on different prices.What's last price? The last price is the price of the most recent executed trade in the market. It's useful for: seeing recent trade activity charting and short-term market behaviourWhat's index price? The index price is a reference price derived from...Published on Apr 15, 2026Updated on May 29, 2026FAQChanges 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 Apr 24, 2023Updated on May 29, 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 Mar 30, 2023Updated on May 29, 2026AnnouncementsTradFi X-Perps vs Real Stocks FAQ
If a corporate action such as a stock split or reverse split changes the number of underlying shares represented by the contract, we may close open positions in the affected X-Perp and list a new contract reflecting the post-corporate-action structure. Where possible, we'll inform users in advance. Cash dividends are treated separately, they aren't supported currently and don't trigger the same position-closure mechanism.Why trade a TradFi X-Perp instead of buying real stock?Published on Jun 9, 2026Updated on Jun 11, 2026FAQMulti-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 Apr 13, 2023Updated on Jun 16, 2026Product documentationSpot Fees comparison: X-Perps account vs Regular account
Our fees differ for users in Europe (UE/EEA) who have opened their derivatives (X-Perps) account and for users who haven't opened a derivatives (X-Perps) account. On this page you can find the fee difference for users of different tiers and the fees for both account options and compare the costs per tier. Your VIP level is determined based on your total accounts assets in EUR or your 30-day...Published on May 18, 2026Updated on May 29, 2026AnnouncementsOKX 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 Dec 5, 2023Updated on May 29, 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 Mar 15, 2024Updated on May 29, 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 Dec 14, 2023Updated on May 29, 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 Mar 27, 2024Updated on May 29, 2026AnnouncementsHow 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 Aug 30, 2023Updated on May 29, 2026Product documentationIntroduction 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 Apr 21, 2026Updated on May 29, 2026Product documentationOpen 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 Nov 9, 2023Updated on May 29, 2026AnnouncementsWhat'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 Jan 15, 2026Updated on May 29, 2026FAQ77How do I start trading X-Perps on OKX?
It covers: Placing a trade from the chart Placing a trade from the order panel Choosing limit vs market Setting take-profit / stop-loss (TP/SL) Reviewing liquidation price Cancelling an order if you change your mindBefore you place an X-Perps order Please make sure: The product is available to your account and region Your suitability assessment is completed (required before accessing X-Perps) You have selected the correct X-Perps contract Your funds are in the correct account path (most setups requirePublished on Apr 9, 2026Updated on May 29, 2026FAQ