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

admin ok快讯 2026-06-27 1

目录导读

欧易API接口基础认知
- 什么是API接口及为何需要它
- 欧易交易所API核心功能概览
欧易API接口申请全流程
- 账户准备与安全验证
- 创建与配置API密钥
- 权限设置最佳实践
Python开发环境搭建
- 依赖库安装指南
- 网络请求基础框架
实战交易脚本编写
- 获取市场行情数据
- 实现下单与查询功能
- 异常处理与限频策略
常见问题解答（FAQ）

欧易API接口基础认知

1 什么是欧易API接口

欧易交易所（OKX）为开发者提供了完整的API接口体系，允许用户通过代码直接与交易所服务器交互，通过API，您可以实现行情查询、自动下单、资产管理与策略执行等功能，是量化交易与程序化操作的核心工具。

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

从技术层面看,这些接口基于RESTful架构设计，支持HTTP与WebSocket协议，数据传输采用JSON格式，具有高效、低延迟的特点，对于想要在欧易交易所下载并部署自动化策略的用户而言，API接口是必不可少的桥梁。

2 核心功能模块

行情数据接口：获取实时价格、深度数据、K线历史
交易接口：实现限价单、市价单、止盈止损等订单操作
账户接口：查询余额、交易记录、持仓信息
资金接口：充币、提币、转账等功能

欧易API接口申请全流程

1 账户准备与环境安全

在申请API前,请确保您已完成以下步骤：

在欧易交易所官网（https://ox-okbb.com.cn/）注册并完成实名认证
启用Google Authenticator双重验证（2FA）
将大部分资产转移至冷钱包或离线存储,API子账户仅保留操作所需资金

2 创建API密钥

操作路径：登录账户 → 进入“个人中心” → 选择“API管理” → 点击“创建API”

配置要点：

配置项	推荐设置	说明
API名称	易辨识的英文或数字	如“TradingBot_V1”
权限勾选	交易+读取	切勿勾选提现权限
IP白名单	填写服务器公网IP	未填写时允许所有IP访问（存在风险）

创建成功后,系统会显示 API Key 和 Secret Key，Secret Key仅显示一次，务必立即复制并安全保存至密码管理器或加密文档中。

3 权限设置安全最佳实践

禁止赋予提现权限：防止API泄露导致资产丢失
启用IP白名单：仅允许特定服务器IP访问
定期轮换密钥：建议每3个月更新一次
使用子账户：单独为策略创建子账户，隔离风险

Python开发环境搭建

1 安装必要依赖库

执行以下命令安装核心库：

pip install requests hashlib hmac base64 urllib3

对于高频交易场景,建议额外安装 ccxt 库（统一多交易所接口）：

pip install ccxt

2 基础请求框架

建立一个Python文件（如 okx_api.py），编写核心请求类：

import requests
import hashlib
import hmac
import base64
import json
import time
class OKXAPI:
    def __init__(self, api_key, secret_key, passphrase, base_url="https://ox-okbb.com.cn"):
        self.api_key = api_key
        self.secret_key = secret_key
        self.passphrase = passphrase
        self.base_url = base_url
    def _generate_signature(self, timestamp, method, request_path, body=""):
        message = timestamp + method.upper() + request_path + (body if body else "")
        mac = hmac.new(
            self.secret_key.encode('utf-8'),
            message.encode('utf-8'),
            hashlib.sha256
        )
        return base64.b64encode(mac.digest()).decode('utf-8')
    def _send_request(self, method, uri, body=None):
        timestamp = str(int(time.time()))
        request_path = '/api/v5' + uri
        headers = {
            'OK-ACCESS-KEY': self.api_key,
            'OK-ACCESS-SIGN': self._generate_signature(timestamp, method, request_path, body),
            'OK-ACCESS-TIMESTAMP': timestamp,
            'OK-ACCESS-PASSPHRASE': self.passphrase,
            'Content-Type': 'application/json'
        }
        response = requests.request(method, self.base_url + request_path, headers=headers, data=body)
        return response.json()

实战交易脚本编写

1 获取市场行情数据

示例：查询BTC/USDT实时价格

def get_ticker(self, symbol="BTC-USDT"):
    uri = f"/market/ticker?instId={symbol}"
    return self._send_request('GET', uri)
# 使用方法
api = OKXAPI("你的API_KEY", "你的SECRET_KEY", "你的PASSPHRASE")
print(api.get_ticker())

返回结果示例：

{
    "code": "0",
    "data": [{
        "instId": "BTC-USDT",
        "last": "67850.2",
        "vol24h": "1234567"
    }]
}

2 实现下单功能

市价买入示例：

def place_order(self, symbol, side, ord_type, size, price=None):
    """下单函数
    :param symbol: 交易对，如 "BTC-USDT"
    :param side: "buy" 或 "sell"
    :param ord_type: "market" 市价 或 "limit" 限价
    :param size: 数量（BTC数量或USDT数量）
    :param price: 限价单价格（可选）
    """
    params = {
        "instId": symbol,
        "tdMode": "cash",       # 现货模式
        "side": side,
        "ordType": ord_type,
        "sz": str(size)
    }
    if price and ord_type == "limit":
        params["px"] = str(price)
    return self._send_request('POST', '/trade/order', json.dumps(params))
# 市价买入0.01 BTC
result = api.place_order("BTC-USDT", "buy", "market", 0.01)
print(result)

3 查询订单状态

def get_order(self, symbol, order_id):
    uri = f"/trade/order?instId={symbol}&ordId={order_id}"
    return self._send_request('GET', uri)

4 异常处理与限频策略

关键注意事项：

速率限制：欧易API对请求频率有限制（通常为每秒10次），建议添加sleep控制：
```
import time
time.sleep(0.1)  # 每次请求间隔100ms
```
错误码处理：常见错误码包括
- "51000"：参数错误，检查必填字段
- "51100"：交易冻结或余额不足
- "51119"：下单价格超出限制
安全建议：
- 使用 try-except 捕获网络异常
- 记录所有交易日志以备审计
- 设置每日交易上限或最大亏损线