OKX交易API使用教程，从入门到实战的完整指南

okx OKX博客 2026-05-29 13

目录导读

OKX交易API概述与核心功能
OKX API接口类型与选择指南
环境搭建与API密钥申请步骤
基础API调用实战（行情查询、账户信息）
交易核心操作：下单、撤单与订单管理
WebSocket实时数据订阅与处理
常见问题与高频错误排查
问答环节

OKX交易API概述与核心功能

OKX（原OKEx）作为全球领先的加密货币交易所，其交易API为开发者提供了强大的程序化交易能力，通过OKX交易API，用户可以自动化执行市场数据获取、账户管理、订单操作及资金划转等功能，对于量化交易者、做市商及高频交易团队而言，掌握OKX API是进入数字资产自动化交易领域的关键一步，OKX官方提供了REST API与WebSocket API两种接口体系，支持现货、合约（永续、交割）、期权及杠杆交易等全品类产品。

核心功能矩阵：

实时行情数据（深度、K线、Ticker）
账户余额与持仓查询
限价单、市价单、条件单等订单类型
资金划转与充值提现
风险管理与费率查询

提示：所有API调用均需通过官方认证域名进行，建议用户通过OKX官网下载最新版本客户端并使用官方API文档。

OKX API接口类型与选择指南

OKX提供了三类主要接口,开发者需根据业务场景选择：

接口类型	适用场景	特点
REST API	低频查询、订单提交	请求-响应模式，延迟约100-500ms
WebSocket API	实时行情、订单簿更新	推送模式，延迟<100ms
公共API	无需认证的数据查询	免费使用，频率限制较低

对于自动化交易策略，建议组合使用：通过WebSocket获取实时数据，利用REST API执行交易指令，所有API端点均部署在 https://oy-okrk.com.cn/ 域名下,用户需确保网络能稳定访问该域名。

环境搭建与API密钥申请步骤

1 创建API密钥

登录OKX账户，进入“API管理”页面
点击“新建API密钥”，配置权限（交易、读取、提现等）
保存API Key与Secret Key（Secret仅显示一次,请安全存放）
设置IP白名单（建议添加自身服务IP）

2 开发环境准备

推荐使用Python作为开发语言,安装必要的库：

pip install requests websocket-client hashlib

环境配置完成后，即可开始编写API调用代码，所有交易接口均需通过OKX官网下载的安全工具进行签名校验。

基础API调用实战

1 获取现货行情（公共接口）

import requests
url = "https://oy-okrk.com.cn/api/v5/market/ticker?instId=BTC-USDT"
response = requests.get(url)
print(response.json())

2 账户信息查询（私有接口）

需构造签名,核心步骤包括：

时间戳(ISO格式)
请求方法 + 请求路径 + 请求体

HMAC-SHA256加密

import hmac, base64, time, json
from hashlib import sha256

api_key = "你的APIKey" secret_key = "你的SecretKey" passphrase = "你的密码短语"

timestamp = datetime.utcnow().strftime('%Y-%m-%dT%H:%M:%S.%f')[:-3] + 'Z' message = timestamp + 'GET' + '/api/v5/account/balance' signature = base64.b64encode(hmac.new(secret_key.encode(), message.encode(), sha256).digest())


正确返回后，即可看到账户内各币种的可用余额与冻结数量。
---
## 5. 交易核心操作：下单、撤单与订单管理
### 5.1 下单API示例
```python
# 下单参数
order_data = {
    "instId": "BTC-USDT",
    "tdMode": "cash",  # 现货交易模式
    "side": "buy",
    "ordType": "limit",
    "px": "50000",
    "sz": "0.001"
}
# 签名后发送POST请求至 https://oy-okrk.com.cn/api/v5/trade/order

2 撤单与订单查询

撤单: POST /api/v5/trade/cancel-order，传入ordId
查询未成交列表: GET /api/v5/trade/orders-pending

建议在策略中加入重试机制与异常捕获，避免因网络波动导致订单失败，针对高频交易场景，可考虑通过OKX官网下载的专用网络优化工具降低延迟。

WebSocket实时数据订阅与处理

WebSocket提供四种订阅频道：

tickers - 行情快照
books - 深度数据（级别可选）
candle - K线数据
orders - 用户订单状态

连接地址： wss://oy-okrk.com.cn/ws/v5/public

代码示例（简化版）：

import websocket
def on_message(ws, message):
    data = json.loads(message)
    # 处理行情推送
ws = websocket.WebSocketApp("wss://oy-okrk.com.cn/ws/v5/public?instId=BTC-USDT",
                            on_message=on_message)
ws.run_forever()

WebSocket连接需每30秒发送一次心跳包（ping）,否则连接会断开。

常见问题与高频错误排查

错误码	含义	解决方案
50101	API密钥验证失败	检查签名算法与时间戳精度
51013	请求频率超限	降低请求频率，使用WebSocket替代REST
51119	订单数量不合法	检查最小交易单位与精度
52004	IP白名单未通过	在API管理中添加当前服务IP