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 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, 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 Apr 13, 2023Updated on Jun 16, 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 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, 2026FAQ13How 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 May 19, 2025Updated on May 29, 2026FAQ21Issues 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, 2026AnnouncementsOKX 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 Nov 29, 2024Updated on May 29, 2026FAQ22How 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 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 Mar 13, 2024Updated on May 29, 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 Sep 25, 2023Updated on May 29, 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 Apr 28, 2025Updated on May 29, 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 Jan 15, 2026Updated on May 29, 2026FAQ79Open 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, 2026Announcements