All
FAQ
Announcements
Product documents
OKX will list WiFi Map (WIFI) for spot trading
OKX is pleased to announce the listing of WiFi Map (WIFI) on our spot trading markets. Trading of WIFI will start according to the following schedule: WIFI deposits open at 05:00 pm UTC on Mar. 31 WIFI /USDT Spot trading opens at 08:00 am UTC on Apr. 7 WIFI withdrawals open at 08:00 am UTC on Apr. 8 WIFI trading opens on OKX Wallet-DEX at 12:00 pm UTC on Apr. 7 WiFi Map is building a community-driven decentralized wireless network, bringing free WiFi to the world.Published on Apr 1, 2023Updated on Nov 17, 2025AnnouncementsOKX API FAQ
Note: if you have any other questions or other API-related inquiries, you can reach out to us by scanning the code below via the app.What's "50119 API key doesn't exist" error? This error usually occurs when your account’s domain doesn’t match your region. For EEA users, please change your API request domain name to eea.okx.com instead of www.okx.com. For US users, please change your API request domain name to us.okx.com instead of www.okx.com.Published on Sep 20, 2024Updated on Mar 3, 2026FAQ127Fast API Launch
OKX Broker has launched the Fast API function to provide additional security to the API Key binding process. As a user connecting to trade with OKX on our brokers' platform, Fast API allows users to log in through OAuth mode and authorize the access token to generate API Keys automatically on behalf of the user.Benefits Swift and safe: Users no longer need to copy their OKX API Key and API Secret manually, just log in to the OKX account and connect to the preferred broker.Published on Jan 5, 2023Updated on Apr 1, 2025Product documentationAnnouncing the P2P API for Super & Diamond Merchants — Trade smarter with P2P API
We’re thrilled to introduce the brand-new P2P API — your key to unlocking ultimate efficiency and customization! What’s the P2P API? The P2P API helps you automate your P2P trading process. Whether you’re handling large order volumes or seeking a customized solution for your business, our P2P API is designed to make your P2P trading more efficient. Why should you be excited about the P2P API?Published on Apr 22, 2025Updated on Feb 9, 2026AnnouncementsOpen API for ETH Staking
Dear valued customer, OKX released the ETH Staking API on November 08, 2023 (UTC). You can keep track of BETH positions and daily yields, as well as stake and unstake through the API. You can also use it to develop and monitor arbitrage strategies to maximize your profits. 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 Nov 17, 2025AnnouncementsSuspension the FIX API service
Dear Valued Customers, Given to the fact that we have listed quite a number of token trading pairs as well as different type of contracts, in order for us to provide a more stable API, we would need to carry out a major upgrade to our current FIX API. The FIX API suspension the service at 00:00 on December 9, 2017 (Beijing Time). The REST API and WebSocket API are still available. Please add our API customer support WeChat (ID: ApiSupport) for API-related questions.Published on Dec 8, 2017Updated on Nov 17, 2025AnnouncementsIssues 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 Nov 17, 2025AnnouncementsSubaccounts, Account Mode, and API Connections FAQ
It cannot be recovered if it is lost.How do I use the API on external platforms? Enter the following details on the external platform or tool: API Key Secret Key PassphraseGood security practices for APIs To keep your account safe: Enable two-factor authentication (2FA) Restrict API usage to trusted IP addresses Revoke API keys that are no longer in usePublished on Mar 2, 2026Updated on Mar 16, 2026FAQChanges to V5 API WebSocket subscription parameter and URL
Adjustment to V5 API WebSocket subscription parameter Currently the websocket subscription parameter uly is mapped to the parameter instFamily. After the adjustment, the subscription parameter uly will return error and no longer be processed. In API requests, please stop using the subscription parameter "uly" and use the subscription parameter "instFamily" instead. 2. V5 API WebSocket adjusts the service address of some channels.Published on Apr 24, 2023Updated on Nov 17, 2025AnnouncementsChanges 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 Nov 17, 2025AnnouncementsV3 Open API Supports USDT-margined Futures Trading
Example: GET /api/futures/v3/accounts/BTC = GET /api/futures/v3/accounts/BTC-USD Note: “POST /api/futures/v3/accounts/margin_mode in setting account mode” in restAPI cannot be used interchangeably. Entering the corresponding underlying index is required while using this API. 2.Involved Endpoint: restAPI a. Information on futures accounts of a single currency: GET /api/futures/v3/accounts/ b. Enquiry about account statements: GET /api/futures/v3/accounts//ledger c.Published on Oct 30, 2019Updated on Nov 17, 2025AnnouncementsWebSocket API is now supporting BCH, ETH and ETC contracts
Dear Valued Customers, The WebSocket API has been upgraded and we now support BCH/ETH/ETC futures. OKX Futures WebSocket Address: wss://real.OKX.com:8443/ws/v3 Please add our API customer support WeChat (ID: ApiSupport) for API-related questions Thank you for your support. OKX 8 December 2017 (Sunday) 21:30Published on Dec 8, 2017Updated on Nov 17, 2025AnnouncementsHow do I back up my wallet to iCloud, Google Drive and Huawei Cloud?
When you recall your first backup password, you can continue using it to restore wallets.How do I back up my wallet with iCloud, Google Drive or Huawei Cloud? If you choose to back up your wallet with iCloud or Google Drive, you'll store your wallet's seed phrase safely in your iCloud, Google Drive or Huawei Cloud. To back up your wallet with iCloud, Google Drive or Huawei Cloud, you need to set a password to protect your seed phrase.Published on Jan 12, 2023Updated on Mar 2, 2026FAQ9,474Klaytn (KLAY) and Net Holding Contest with 200% APY Now Available
Dear valued customers, We are pleased to announce that Klaytn(KLAY)is now listed on OKX. Please take note of the following go-live schedule: 1. KLAY Deposit - 11:00 September 3, 2020 (UTC); 2. KLAY Spot Trading - (KLAY/USDT, KLAY/BTC markets) - 09:00 September 10, 2020 (UTC); 3. KLAY Withdrawal – 09:00 September 14, 2020 (UTC) Due to spot system upgrade, the KLAY spot trading would be adjusted as...Published on Sep 3, 2020Updated on Nov 17, 2025AnnouncementsV3 Open API Supports USDT-margined Perpetual Swap Trading
Public - obtain contract information: GET /api/swap/v3/instruments - - - - returning necessary strings with the response After the upgrade, your program will remain unaffected, but new strings will be added to the existing API. Thank you for your understanding. The V3 API offers more stable, efficient experience and more comprehensive functionalities than the V1 API. As V1 Restful API will be terminated as scheduled soon, we suggest you switch to V3 API for trading.Published on Nov 25, 2019Updated on Nov 17, 2025Announcements