如何在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事件，并在延迟后尝试重新连接。商店订单在本地订购以从中断中恢复。