如何在OKX上使用API進行自動交易

OKX API可以通過REST和WebSocket接口啟用自動交易，從而允許使用安全HMAC身份驗證的訂單放置，實時數據流和帳戶管理。

2025/08/07 17:21

了解自動交易的OKX API

OKX API為用戶提供了一個強大的接口，以使其自動化其交易策略，訪問實時市場數據並以編程方式管理其帳戶。在啟動任何自動交易之前，必須了解OKX提供的API類型。該平台支持REST API ， WebSocket API和Web3.js API ，前兩個與自動交易最相關。 REST API允許您使用HTTP請求下訂單，檢查餘額並檢索歷史數據。 Websocket API可以實時流媒體數據，訂單更新和帳戶更改的延遲較低。

要開始，您必須從OKX帳戶生成一個API密鑰。導航到您的帳戶設置下的API管理部分。在這裡，您將通過指定名稱，密碼和綁定的IP地址來創建一個新的API密鑰。限制對特定IP的訪問以防止未經授權的用法至關重要。生成的密鑰由三個組件組成： API鍵，秘密密鑰和密碼。這些必須安全地存儲，因為它們可以完全訪問您的交易帳戶。

建立您的開發環境

要有效地使用OKX API，您需要一個適當的開發環境。大多數開發人員由於其簡單性和豐富的圖書館生態系統而使用Python 。安裝Python（最好是3.8版或更高版本），並設置一個虛擬環境來管理依賴關係。使用PIP安裝所需的軟件包，例如HTTP通信requests和用於處理WebSocket連接的websockets 。

 pip install requests websockets

接下來，創建一個配置文件（例如， config.py ），以安全地存儲API憑據。切勿將鍵在主腳本中進行硬編碼。您的配置應包括：

• API鍵
• 秘密鑰匙
• 密碼
• 基本URL （例如， https://www.okx.com休息）

如果您使用版本控件，請確保將此文件添加到.gitignore 。這樣可以防止意外暴露敏感數據。

使用OKX API進行認證請求

OKX使用HMAC-SHA256加密進行請求身份驗證。每個私人API請求都必須包括具有特定字段的標題： OK-ACCESS-KEY ， OK-ACCESS-SIGN ， OK-ACCESS-TIMESTAMP和OK-ACCESS-PASSPHRASE 。簽名是通過連接時間戳，HTTP方法，端點路徑和請求主體（如果有）來生成的，然後用您的秘密鍵簽名。

這是在Python中生成簽名的方法：

 import hmac
 import hashlib
 import json Def Generate_signature（時間戳，方法，URL，BODY，SERTIC_KEY）：




message = timestamp + method + url + (json.dumps(body) if body else '') mac = hmac.new(bytes(secret_key, 'utf-8'), bytes(message, 'utf-8'), hashlib.sha256) return mac.hexdigest()
將此功能包含在您的API包裝器中。時間戳必須採用ISO格式（例如， 2024-04-05T12:00:00.000Z ）。始終驗證系統時鐘與UTC同步以避免身份驗證錯誤。
 
通過REST API下訂單
要自動執行交易，請使用位置訂單端點。端點URL為/api/v5/trade/order 。您必鬚髮送帶有包含所需參數的JSON主體的POST請求：
 
Intid ：儀器ID（例如， BTC-USDT-SWAP ）
 TDMODE ：貿易模式（ cash ， isolated或cross ）
 OrdType ：訂單類型（ limit ， market ， post_only等）
 SZ ：訂單尺寸
PX ：價格（限額訂單要求）
示例請求主體：
 
{
 'instid'：'btc-usdt-swap'，
 'tdmode'：'cross'，
 'ordtype'：“限制”，
 'sz'：'0.001'，
 'px'：'60000'
 }

使用requests庫發送請求：

 import requests
 from config import API_KEY, SECRET_KEY, PASSPHRASE url ='https://www.okx.com/api/v5/trade/order'
標題= {




'OK-ACCESS-KEY': API_KEY, 'OK-ACCESS-PASSPHRASE': PASSPHRASE, 'Content-Type': 'application/json'
 }
 
身體= {
 
'instId': 'BTC-USDT-SWAP', 'tdMode': 'cross', 'ordType': 'limit', 'sz': '0.001', 'px': '60000'
 }
 
時間戳='2024-04-05T12：00：00.000Z'
簽名= generate_signature（Timestamp，'post'，'/api/v5/trade/order'，body，secret_key）
 
標題['ok-access-sign'] =簽名
標頭['OK-ACCESS-TIMESTAMP'] =時間戳
 
響應= requests.post（url，標頭=標題，json = body）
打印（response.json（））

檢查code和msg的響應。 0 code表示成功。

使用Websocket流媒體市場數據

對於實時交易決策，請連接到OKX的Websocket API 。這使您可以接收有關訂單書，交易和訂單狀態的實時更新。使用websockets庫建立連接到wss://ws.okx.com:8443/ws/v5/public for Public Channels或wss://ws.okx.com:8443/ws/v5/private for Private Data。

訂閱股票或深度渠道以監視價格變化：

 import asyncio
 import websockets
 import json異步def lister_to_ticker（）：




uri = 'wss://ws.okx.com:8443/ws/v5/public' async with websockets.connect(uri) as websocket: subscribe_message = { 'op': 'subscribe', 'args': [ { 'channel': 'tickers', 'instId': 'BTC-USDT' } ] } await websocket.send(json.dumps(subscribe_message)) while True: response = await websocket.recv() data = json.loads(response) if 'data' in data: print('Latest price:', data['data'][0]['last'])
運行此Coroutine以連續接收更新。處理斷開連接並實現重新連接邏輯以符合魯棒性。
 
管理風險和監控訂單
自動交易需要持續監控。使用獲取訂單詳細信息端點（ /api/v5/trade/order ）以按ordId檢查特定訂單的狀態。如果市場條件發生了變化，則使用取消訂單端點（ /api/v5/trade/cancel-order ）取消訂單。
 
實施記錄以記錄所有操作：
 
import logging
 logging.basicconfig（fileName ='trading.log'，level = logging.info）
 
logging.info（f'Order放置：{response.json（）}'）

設置警報，以獲取失敗的請求或意外的價格變動。如果損失超過閾值，請使用斷路器停止交易。

常見問題

我可以在不啟用兩因素身份驗證（2FA）的情況下使用OKX API嗎？

否。出於安全原因，OKX需要在您的帳戶上啟用2FA，然後才能創建API鍵。這為未經授權的訪問提供了額外的保護層。

OKX API適用於什麼速率限制？

OKX基於請求類型強加了速率限制。公共端點每2秒最多允許20個請求。私有端點限制為每2秒鐘的每2秒鐘，每個API鍵。超過這些限制會導致429誤差。

可用於OKX API開發的TestNet嗎？

是的。 OKX提供了可通過不同的基本URL訪問的演示交易環境： https://www.okx.com 。您可以模擬交易而不冒險實際資金。在配置中切換基本URL，並使用特定於演示的API鍵。

如何處理API停機時間或連接損失？

用指數向後實現重試邏輯。對於WebSocket連接，請聆聽close事件，並在延遲後嘗試重新連接。商店訂單在本地訂購以從中斷中恢復。