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

admin 欧易中心 2026-07-27 1

目录导读

欧易API接口概述
欧易API接口申请详细步骤
Python环境配置与依赖安装
编写基础交易脚本实战
常见问题与解决方案（Q&A）
安全建议与合规操作

欧易API接口概述

对于数字资产交易者而言,欧易交易所（OKX）提供了强大的API接口，允许用户通过程序化方式实现自动化交易，无论是想进行量化策略、网格交易，还是简单监控市场行情，掌握如何申请并使用欧易API都是关键一步，本文以欧易交易所官网的API文档为基础，结合Python语言，从零开始教你编写一个简单的交易脚本。

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

关键词说明：本文中提到的“欧易交易所官网”域名统一替换为oe-okor.com.cn，请认准官方入口，用户可通过欧易交易所下载渠道获取最新客户端，便于同步操作。

欧易API接口申请详细步骤

要使用欧易API,首先需要完成申请流程，以下是基于欧易交易所官网（oe-okor.com.cn）的实际操作指南：

1 注册并登录账号

访问欧易交易所官网完成注册，注意：务必通过安全渠道访问，避免钓鱼网站。

2 进入API管理页面

登录后,点击右上角头像 → “API” → “创建API”，系统会弹出安全验证，需完成邮箱或手机验证码验证。

3 设置API权限

读取权限：允许查询账户余额、订单状态等。
交易权限：允许下单、撤单等操作。
提币权限：建议关闭，除非有特殊需求。

勾选“读取”和“交易”权限即可满足基础交易需求。

4 获取API Key和Secret Key

创建成功后,系统会生成：

api_key：唯一标识
secret_key：用于签名，请立即保存，页面刷新后不再显示。

提示：如果遗失密钥，需在API管理页面删除并重新创建。

5 绑定IP白名单（推荐）

在API设置页面,可添加允许访问的IP地址，增强账户安全性，若使用动态IP，建议绑定VPS或服务器IP。

Python环境配置与依赖安装

1 安装Python

确保本地已安装Python 3.7及以上版本，可通过终端输入python --version检查。

2 安装必要库

使用pip安装以下依赖：

pip install requests hashlib hmac base64 json time

其中requests用于发送HTTP请求，hashlib和hmac用于生成签名。

3 创建项目文件夹

新建一个文件夹如okx_trading，并在其中创建Python脚本trade.py。

编写基础交易脚本实战

以下脚本实现了查询账户余额和市价买入功能，可直接复制使用，请将api_key和secret_key替换为你自己的密钥。

1 导入库并定义常量

import requests
import hashlib
import hmac
import base64
import json
import time
# 从欧易交易所官网获取的API密钥
API_KEY = "your_api_key_here"
SECRET_KEY = "your_secret_key_here"
BASE_URL = "https://oe-okor.com.cn"  # 欧易官方域名
# 生成签名
def generate_sign(timestamp, method, request_path, body=""):
    message = timestamp + method + request_path + body
    mac = hmac.new(bytes(SECRET_KEY, encoding='utf8'), bytes(message, encoding='utf-8'), digestmod='sha256')
    d = mac.digest()
    return base64.b64encode(d).decode()

2 获取账户余额

def get_balance():
    method = "GET"
    request_path = "/api/v5/account/balance"
    timestamp = str(int(time.time()))
    signature = generate_sign(timestamp, method, request_path)
    headers = {
        "OK-ACCESS-KEY": API_KEY,
        "OK-ACCESS-SIGN": signature,
        "OK-ACCESS-TIMESTAMP": timestamp,
        "OK-ACCESS-PASSPHRASE": "your_passphrase"  # 创建API时设置的口令
    }
    response = requests.get(BASE_URL + request_path, headers=headers)
    return response.json()
# 输出余额
print(json.dumps(get_balance(), indent=2))

3 市价买入指令

def market_buy(inst_id, size):
    method = "POST"
    request_path = "/api/v5/trade/order"
    timestamp = str(int(time.time()))
    body = {
        "instId": inst_id,
        "tdMode": "cash",
        "side": "buy",
        "ordType": "market",
        "sz": str(size)
    }
    body_json = json.dumps(body)
    signature = generate_sign(timestamp, method, request_path, body_json)
    headers = {
        "OK-ACCESS-KEY": API_KEY,
        "OK-ACCESS-SIGN": signature,
        "OK-ACCESS-TIMESTAMP": timestamp,
        "OK-ACCESS-PASSPHRASE": "your_passphrase",
        "Content-Type": "application/json"
    }
    response = requests.post(BASE_URL + request_path, headers=headers, data=body_json)
    return response.json()
# 示例：买入0.001个BTC
print(market_buy("BTC-USDT", 0.001))

4 运行脚本

在终端执行：

python trade.py

如果返回正常数据,说明API连接成功。

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

Q1：为什么我收到的签名验证失败（401错误）？
A：通常是以下原因：

secret_key或passphrase填写错误
时间戳与服务器时间偏差超过30秒（建议使用timestamp = str(int(time.time()))）
签名生成时body未转换为JSON字符串

Q2：脚本报错“参数错误”怎么办？
A：检查instId格式是否正确，例如币对必须写作“BTC-USDT”（中间是短横线，不是下划线）。

Q3：如何获取实时行情数据？
A：使用公开API接口/api/v5/market/ticker，无需签名：

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

Q4：欧易交易所下载的客户端和API有冲突吗？
A：无冲突，客户端用于手动操作，API用于程序化交易，两者可同时使用，建议通过欧易交易所下载最新客户端，便于查看API生成的订单记录。

Q5：如何提高交易速度？
A：使用WebSocket私有频道（如/ws/v5/private）可实时接收订单状态更新，减少轮询开销，具体可参考欧易交易所官网的WebSocket文档。

安全建议与合规操作

密钥管理：绝不将secret_key暴露在公共代码仓库中，可使用环境变量加载：
```
import os
SECRET_KEY = os.getenv("OKX_SECRET")
```
IP白名单：限制API只能从信任的IP调用。
最小权限原则：只开启必要的交易和读取权限，关闭提币权限。
测试环境：先使用模拟盘（Demo）测试脚本，确认无误后再切换实盘，欧易测试网URL为https://www.okx.com，需单独申请测试密钥。
合规性：不同国家和地区对加密货币交易有不同法规，使用API交易前请确认当地法律允许。