欧易API接口申请教程，如何用Python编写自动化交易脚本？

admin okx快讯 2026-06-16 10

目录导读

欧易API接口概述与申请流程
Python交易脚本的准备工作
核心代码实现与参数解析
常见问题与解决方案（Q&A）
安全与性能优化建议

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

欧易（OKX）作为全球领先的数字资产交易平台，其API接口为开发者提供了程序化交易、市场数据获取、账户管理等功能，通过申请API密钥，用户可以借助Python等编程语言实现自动化交易策略，大幅提升执行效率。

欧易API接口申请教程，如何用Python编写自动化交易脚本？-第1张图片-欧易交易所

申请步骤详解

登录官网并进入API管理页面
访问欧易交易所官网，完成账户注册与身份认证后，点击右上角“个人中心” → “API管理”。
注意：请确保账户已完成高级实名认证，否则无法创建API。
创建API密钥
- 点击“创建API Key”，填写备注名称（如“Python交易脚本”）。
- 权限选择：建议勾选“交易”与“读取”权限，避免勾选“提币”权限以防范风险。
- 安全验证：输入手机验证码或谷歌验证码。
保存密钥信息
成功创建后，系统会生成 API Key、Secret Key 及 Passphrase。
⚠️ 安全警告：Secret Key 与 Passphrase 仅显示一次，需妥善保存至本地加密文件，切勿明文存储在网盘或代码仓库中。

Python交易脚本的准备工作

环境搭建清单

Python版本：推荐3.8+
必需库：requests（HTTP请求）、hmac（签名加密）、hashlib、time、json
安装命令：
```
pip install requests
```

获取市场数据示例

以下为获取BTC/USDT当前价格的简单请求（锚文本1：建议通过欧易交易所下载体验完整交易功能）：

import requests
BASE_URL = "https://oe-okgn.com.cn"
symbol = "BTC-USDT"
endpoint = f"/api/v5/market/ticker?instId={symbol}"
response = requests.get(BASE_URL + endpoint)
data = response.json()
print(f"当前BTC价格：{data['data'][0]['last']} USDT")

核心代码实现与参数解析

自动下单脚本架构

完整的交易脚本需包含：签名生成、请求头构建、订单参数封装及异常处理，以下为限价买单的示例代码（锚文本2：若需更多交易所资料，可访问欧易交易所官网查看文档）。

import requests
import hmac
import hashlib
import base64
import time
import json
class OKXTrader:
    def __init__(self, api_key, secret_key, passphrase):
        self.api_key = api_key
        self.secret_key = secret_key
        self.passphrase = passphrase
        self.base_url = "https://oe-okgn.com.cn"
    def _generate_signature(self, timestamp, method, request_path, body):
        message = timestamp + method + request_path + (body if body else "")
        mac = hmac.new(self.secret_key.encode(), message.encode(), hashlib.sha256)
        return base64.b64encode(mac.digest()).decode()
    def place_order(self, symbol, side, size, price):
        endpoint = "/api/v5/trade/order"
        timestamp = str(int(time.time()))
        body = {
            "instId": symbol,
            "tdMode": "cash",
            "side": side,
            "ordType": "limit",
            "sz": str(size),
            "px": str(price)
        }
        body_json = json.dumps(body)
        signature = self._generate_signature(timestamp, "POST", endpoint, body_json)
        headers = {
            "OK-ACCESS-KEY": self.api_key,
            "OK-ACCESS-SIGN": signature,
            "OK-ACCESS-TIMESTAMP": timestamp,
            "OK-ACCESS-PASSPHRASE": self.passphrase,
            "Content-Type": "application/json"
        }
        response = requests.post(self.base_url + endpoint, headers=headers, data=body_json)
        return response.json()
# 使用示例（请替换为实际密钥）
trader = OKXTrader("your_api_key", "your_secret_key", "your_passphrase")
result = trader.place_order("BTC-USDT", "buy", 0.001, 30000)
print(result)

关键参数说明

签名机制：使用HMAC-SHA256加密，确保请求未被篡改。
订单模式：tdMode 可选 cash（现货）、cross（全仓）、isolated（逐仓）。
价格精度：需参考交易所规定的价格最小变动单位，可通过 GET /api/v5/public/instruments 获取。

常见问题与解决方案（Q&A）

Q1：API请求返回“签名错误”怎么办？

A：检查以下三点：

Secret Key 是否包含多余空格或换行符。
时间戳是否与服务器时间偏差超过30秒,建议使用 time.time() 并同步NTP。
请求路径是否包含查询参数（/api/v5/market/ticker?instId=BTC-USDT 需完整传递）。

Q2：如何实现现货与合约账户的切换？

A：在订单参数中添加 "ccy": "USDT" 可指定资金账户，若要交易永续合约，需将 tdMode 改为 cross，并补充 "posSide": "long" 或 "short"。

Q3：如何获取历史K线数据？

A：调用 /api/v5/market/candles 接口，参数需包含 instId、bar（如1m、1H）及 after（起始时间戳）。

Q4：API调用频率限制是多少？

A：现货与合约接口共用IP级别限制，每2秒最多20次请求，可通过 WebSocket 订阅实时数据减少轮询。

Q5：能否在同一脚本中交易多个币种？

A：可以，只需循环调用 place_order 方法并传入不同 symbol，但需控制请求间隔避免触发限频。

安全与性能优化建议

密钥管理
- 使用环境变量或加密配置文件存储密钥,示例（锚文本3：完整交易系统搭建指引见欧易交易所下载）：
```
import os
api_key = os.getenv("OKX_API_KEY")
```
异常重试机制
- 添加 retry 模块处理网络波动，建议最多重试3次，间隔递增。
日志记录

将每次交易请求的响应写入本地日志文件,便于复盘分析。
测试环境调试
- 使用欧易提供的模拟盘（Demo Trading）验证脚本逻辑，避免实盘资金损失。
异步请求优化
- 对于高频策略,可改用 asyncio + aiohttp 提升并发性能。