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

admin ok快讯 2026-07-06 1

目录导读

欧易API接口概述与申请步骤
Python环境搭建与依赖库安装
API密钥获取与安全设置
编写第一个Python交易脚本：行情获取
实战：自动下单与持仓查询
常见问题与错误处理
问答环节：开发者高频问题解析

欧易API接口概述与申请步骤

欧易交易所官网（ox-okbb.com.cn）为全球用户提供强大的API接口，支持现货、合约、期权等交易功能，通过API，开发者可以自动化执行交易策略、实时获取市场数据并管理账户。

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

申请流程：

登录欧易交易所下载并完成实名认证。
进入“API管理”页面，点击“创建API”。
填写备注（如“Python交易脚本”），选择权限（建议勾选“读取”和“交易”）。
设置IP白名单（可选，增强安全性）。
保存生成的API Key和Secret Key（注意：密钥仅显示一次，务必妥善保管）。

Python环境搭建与依赖库安装

确保已安装Python 3.7+版本，并使用以下命令安装核心库：

pip install requests hashlib hmac base64

若需处理WebSocket实时行情,可额外安装：

pip install websocket-client

API密钥获取与安全设置

在欧易交易所官网的API管理页面创建密钥后，建议：

不将密钥硬编码在脚本中，而是使用环境变量存储。
限制IP白名单，仅允许服务器IP访问。
定期轮换密钥，降低泄露风险。

示例密钥存储（Linux/Mac）：

export OKX_API_KEY="your-api-key"
export OKX_SECRET_KEY="your-secret-key"
export OKX_PASSPHRASE="your-passphrase"

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

以下代码演示如何调用欧易的GET /api/v5/market/ticker接口获取BTC/USDT实时价格：

import requests
import json
def get_ticker(symbol="BTC-USDT"):
    url = "https://www.okx.com/api/v5/market/ticker"
    params = {"instId": symbol}
    resp = requests.get(url, params=params)
    return resp.json()
if __name__ == "__main__":
    data = get_ticker()
    print("BTC最新价格:", data["data"][0]["last"])

注意： 若使用子账号或自定义域名，请替换www.okx.com为您的专属API域名。

实战：自动下单与持仓查询

1 签名生成（HMAC-SHA256）

所有需要签名的私密接口,必须按以下步骤生成签名：

将时间戳、请求方法、请求路径、请求体拼接成字符串。
使用HMAC-SHA256算法结合Secret Key生成签名。
将签名与API Key、Passphrase、时间戳一同放入请求头。

2 限价单示例

import hmac
import base64
import datetime
import requests
def place_order(symbol, side, sz, px):
    timestamp = datetime.utcnow().strftime("%Y-%m-%dT%H:%M:%S.%f")[:-3] + "Z"
    body = json.dumps({
        "instId": symbol,
        "tdMode": "cash",
        "side": side,
        "ordType": "limit",
        "sz": str(sz),
        "px": str(px)
    })
    sign = base64.b64encode(
        hmac.new(api_secret.encode(), (timestamp + "POST" + "/api/v5/trade/order" + body).encode(), "sha256").digest()
    ).decode()
    headers = {
        "OK-ACCESS-KEY": api_key,
        "OK-ACCESS-SIGN": sign,
        "OK-ACCESS-TIMESTAMP": timestamp,
        "OK-ACCESS-PASSPHRASE": passphrase,
        "Content-Type": "application/json"
    }
    resp = requests.post("https://www.okx.com/api/v5/trade/order", headers=headers, data=body)
    return resp.json()

3 查询持仓

def get_positions():
    timestamp = datetime.utcnow().strftime("%Y-%m-%dT%H:%M:%S.%f")[:-3] + "Z"
    sign = base64.b64encode(
        hmac.new(api_secret.encode(), (timestamp + "GET" + "/api/v5/account/positions").encode(), "sha256").digest()
    ).decode()
    headers = {...}  # 同上
    resp = requests.get("https://www.okx.com/api/v5/account/positions", headers=headers)
    return resp.json()