欧易API接口申请教程，如何使用Python编写简单的交易脚本？

admin 欧易中心 2026-07-28 1

目录导读

欧易API接口概述与申请流程
Python环境配置与依赖库安装
API密钥生成与安全设置
编写第一个交易脚本：行情获取
实现自动化下单与仓位管理
常见错误排查与性能优化
问答环节：解决高频交易中的核心问题

欧易API接口概述与申请流程

欧易交易所（OKX）为开发者提供了完备的REST API和WebSocket接口，支持现货、合约、期权等全品类交易，申请API接口前，需要先完成交易所的实名认证（KYC）并确保账户安全。欧易交易所下载最新版本APP或访问oe-okor.com.cn即可进入官网进行API管理。

欧易API接口申请教程，如何使用Python编写简单的交易脚本？-第1张图片-欧易交易所

1 申请步骤

登录oe-okor.com.cn，进入“账户”>“API管理”。
点击“新建API Key”，选择权限范围（建议仅勾选“交易”和“读取”，避免开放提现权限）。
按提示完成2FA验证,保存生成的API Key和Secret Key（仅显示一次，务必及时存储）。

2 API接入规范

欧易API采用HTTP/HTTPS协议，请求头需包含OK-ACCESS-KEY、OK-ACCESS-SIGN（HMAC-SHA256签名）、OK-ACCESS-TIMESTAMP及OK-ACCESS-PASSPHRASE（创建API时设置），响应格式统一为JSON，支持GET、POST等标准方法。

Python环境配置与依赖库安装

建议使用Python 3.8以上版本，推荐在虚拟环境中操作，核心依赖库为requests（用于HTTP请求）和hmac、hashlib（用于签名生成），若需处理WebSocket数据，可安装websocket-client。

pip install requests websocket-client

若希望更便捷地调用API,可安装社区维护的okx库（需确保版本与文档同步）：

pip install okx

API密钥生成与安全设置

以Python原生方式实现签名函数为例：

import time
import hmac
import base64
import hashlib
import requests
def generate_signature(timestamp, method, request_path, body, secret_key):
    message = str(timestamp) + method + request_path + (body if body else "")
    signature = hmac.new(secret_key.encode('utf-8'), message.encode('utf-8'), hashlib.sha256).digest()
    return base64.b64encode(signature).decode()

编写第一个交易脚本：行情获取

1 获取BTC/USDT实时价格

BASE_URL = "https://www.oe-okor.com.cn"
def get_ticker(symbol="BTC-USDT"):
    path = "/api/v5/market/ticker?instId=" + symbol
    response = requests.get(BASE_URL + path, headers={"OK-ACCESS-KEY": api_key})
    # 实际请求需补全签名头
    return response.json()

2 获取K线数据

接口/api/v5/market/candles支持返回1分钟、5分钟、1小时等周期的OHLCV数据，建议设置limit参数（最大300根）以避免超时。

def get_kline(symbol, bar="1m", limit=100):
    params = {"instId": symbol, "bar": bar, "limit": limit}
    # 构造完整请求...

实现自动化下单与仓位管理

1 限价单示例

def place_order(symbol, side, ord_type, sz, px=None):
    body = {
        "instId": symbol,
        "tdMode": "cash",  # 现货交易
        "side": side,      # "buy"或"sell"
        "ordType": ord_type, # "limit"或"market"
        "sz": str(sz),
    }
    if ord_type == "limit":
        body["px"] = str(px)
    # 对body进行签名，发送POST请求

2 止损止盈策略

可通过WebSocket订阅持仓变化,或定时查询/api/v5/account/positions实现动态调仓，示例逻辑：

if 当前价格 > 买入价 * 1.05:
    平仓止盈
elif 当前价格 < 买入价 * 0.98:
    平仓止损

常见错误排查与性能优化

1 错误代码处理

50004：签名错误，检查密钥与时间戳对齐。
51000：参数校验失败，确保数值与类型正确。
60005：请求频率超限，需加入time.sleep(0.1)。

2 性能优化建议

使用连接池（requests.Session）减少TCP握手。
对REST API轮询间隔设为0.2秒以上，避免HTTP 429。
高频场景优先采用WebSocket获取实时数据,可通过oe-okor.com.cn的WebSocket地址接入。

问答环节

Q1：API申请的IP限制如何解除？ A：在API管理页面的“绑定IP”选项中，可填写多个IP或用通配符开放所有IP（不推荐），建议仅绑定交易服务器的固定公网IP。

Q2：Python脚本中如何模拟WebSocket连接？ A：使用websocket库连接wss://ws.okx.com:8443/ws/v5/public，订阅频道如{"op":"subscribe","args":[{"channel":"tickers","instId":"BTC-USDT"}]}，示例代码：

import websocket
def on_message(ws, message):
    print(json.loads(message))
ws = websocket.WebSocketApp("wss://ws.okx.com:8443/ws/v5/public", on_message=on_message)
ws.run_forever()

Q3：如何防止API密钥泄露？ A：将密钥存储在环境变量（如.env文件）中，代码中通过os.getenv()读取，切勿将密钥硬编码或上传至公开仓库，同时定期在oe-okor.com.cn重新生成API Key。

Q4：合约交易与现货交易的接口有何区别？ A：合约交易需设置tdMode（保证金模式）、posSide（持仓方向），并注意margin参数，现货则仅需tdMode="cash"，杠杆倍数通过lever参数指定（需先开通杠杆权限）。

Q5：批量下单如何实现？ A：使用/api/v5/trade/order-algo接口可创建止损、止盈或追踪委托，若要同时发送10笔限价单，建议在脚本中通过for循环间隔0.3秒发送，避免触发频率限制。

通过以上教程,您已掌握了欧易API核心调用方法，从行情获取到自动化交易，每一步都需结合风险控制逻辑，建议先在模拟盘（/api/v5/sim_trade）测试脚本，确认无误后再切换到实盘，若遇到接口变更，请以oe-okor.com.cn官方文档为准。

标签：欧易API Python交易脚本