All
FAQ
Announcements
Product documents
OKX API FAQ
This is the password you filled in when applying for the API key. You need to remember it yourself. Once you forget it, you can't retrieve it and you'll need to create a new API key.How do I create an API key? On the App: Log in to your OKX account > Select Menu > Scroll down and select API > Create API key On the Web: Log in to your OKX account > Go to your Profile and select API and connections > Create API keyHow do I create a demo disk API key?Published on Sep 20, 2024Updated on Mar 23, 2026FAQ133Fast 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 documentationOKX deepens relationship with TradingView to bring trading experience to Mobile.
The collaboration between OKX and TradingView has now made it possible for traders to connect their TradingView account to OKX and place both Spot and Derivatives trades directly within TradingView on mobile. The integration with TradingView aims to provide a more seamless and user-friendly trading experience. Users can connect their OKX account to web and desktop versions of TradingView, as well as its mobile app, eliminating the need to switch between platforms.Published on Mar 21, 2023Updated on Nov 17, 2025AnnouncementsAnnouncing 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, 2025AnnouncementsMy mobile phone isn't working, what should I do?
If your mobile phone isn't working properly, or you've lost access to it, or you can't get SMS codes, try the following:My SMS codes aren’t working on OKX Try these fixes first to check if you can get codes working again: Automate your mobile phone time.Published on Aug 22, 2023Updated on Jan 27, 2026FAQ461Issues 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, 2025AnnouncementsHow do I submit my proof of address (POA)?
Mobile phone statements are not acceptable. Mortgage statement which is issued by a regulated financial institution. Correspondence from a Central or Local Government Authority, Department or Agency such as pension, unemployment benefits, tax documents and housing benefits. National ID card/Residence permit/Driver license. Document should include the customer's full name, photograph & address. Note: The POA must be your residential address. Your full name on the POA must match your legal name.Published on Sep 5, 2023Updated on Feb 23, 2026FAQ4Changes 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, 2025AnnouncementsKlaytn (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