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

admin 欧易中心 2026-07-21 3

目录导读

第一部分：欧易交易所API接口概述与申请流程
第二部分：Python环境准备与依赖库安装
第三部分：编写简易交易脚本的核心步骤
第四部分：实战代码示例与异常处理
第五部分：常见问题问答（FAQ）

第一部分：欧易交易所API接口概述与申请流程

欧易交易所官网（oe-okor.com.cn）作为全球领先的数字资产交易平台，为开发者提供了功能完备的API接口，覆盖行情查询、资产管理和自动交易等功能,申请API接口是编写自动化交易脚本的第一步。

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

1 如何申请API Key？

登录欧易交易所官网后，在“账户安全”或“API管理”模块中，点击“创建API”按钮，系统会生成一对API Key和Secret Key，请务必妥善保存——尤其是Secret Key，它用于签名验证，泄露可能导致资产风险，申请时需设置IP白名单和权限（如只读、交易、提币）,建议根据脚本需求最小化权限。

2 API接口的文档结构

欧易交易所API分为REST接口和WebSocket接口，REST接口用于单次请求（如查询余额、下单），WebSocket则用于实时行情推送，文档中明确标注了请求方法（GET/POST）、参数格式（JSON）和签名算法（HMAC-SHA256）。

第二部分：Python环境准备与依赖库安装

编写交易脚本推荐使用Python 3.8及以上版本,需要安装以下核心库：

pip install requests websocket-client pandas

requests：发送HTTP请求，与API交互
websocket-client：处理实时数据流
pandas：处理交易数据，便于回测与分析

1 环境验证

在终端输入python --version确认Python版本无误，建议使用虚拟环境（venv）隔离项目依赖。

第三部分：编写简易交易脚本的核心步骤

1 签名生成逻辑

欧易交易所API要求每次请求携带签名（按时间戳、请求方法、请求路径和参数组合计算），参考官方文档,签名步骤为：

拼接固定格式的字符串
使用Secret Key通过HMAC-SHA256加密
将签名结果放入请求头中的OK-ACCESS-SIGN字段

2 账户信息查询脚本

以下为查询当前账户余额的简易示例：

import requests
import hmac
import base64
import datetime
import json
API_KEY = 'your_api_key'
SECRET_KEY = 'your_secret_key'
PASSPHRASE = 'your_passphrase'  # 创建API时设置
def get_timestamp():
    return datetime.datetime.utcnow().isoformat()[:19] + 'Z'
def sign(message, secret_key):
    mac = hmac.new(secret_key.encode(), message.encode(), digestmod='sha256')
    return base64.b64encode(mac.digest()).decode()
headers = {
    'OK-ACCESS-KEY': API_KEY,
    'OK-ACCESS-SIGN': sign(get_timestamp() + 'GET' + '/api/v5/account/balance', SECRET_KEY),
    'OK-ACCESS-TIMESTAMP': get_timestamp(),
    'OK-ACCESS-PASSPHRASE': PASSPHRASE,
    'Content-Type': 'application/json'
}
response = requests.get('https://oe-okor.com.cn/api/v5/account/balance', headers=headers)
print(response.json())

关键点：每次请求务必生成新的时间戳,避免签名过期。

3 下单脚本编写

下单需携带交易对、买卖方向、数量和价格,以下为限价买单示例：

body = {
    'instId': 'BTC-USDT',
    'tdMode': 'cash',
    'side': 'buy',
    'ordType': 'limit',
    'px': '45000',
    'sz': '0.01'
}
body_json = json.dumps(body)
signature = sign(get_timestamp() + 'POST' + '/api/v5/trade/order' + body_json, SECRET_KEY)
response = requests.post('https://oe-okor.com.cn/api/v5/trade/order', headers=headers, data=body_json)
print(response.json())

第四部分：实战代码示例与异常处理

1 完整的交易循环

将查询余额、获取行情、条件判断与下单整合为一个循环：

import time
def trading_cycle():
    while True:
        # 查询账户余额
        balance_data = get_account_balance()
        if balance_data['code'] == '0':
            btc_balance = float(balance_data['data'][0]['detail'][0]['bal'])
        else:
            print('余额查询失败')
            continue
        # 获取BTC当前价格
        ticker = get_ticker('BTC-USDT')
        current_price = float(ticker['data'][0]['last'])
        # 简单策略：当价格低于44000且余额足够时买入
        if current_price < 44000 and btc_balance < 0.1:
            order_body = create_order('BTC-USDT', 'buy', current_price, 0.01)
            if order_body['code'] == '0':
                print('买入成功')
            else:
                print('买入失败:', order_body['msg'])
        time.sleep(60)  # 每分钟轮询
trading_cycle()

2 错误处理机制

网络超时：设置requests的timeout参数（如timeout=10），并捕获requests.exceptions.Timeout异常。
API频率限制：欧易交易所API有频率限制（如每秒20次），建议添加time.sleep(0.05)避免被限流。
签名错误：检查时间戳格式是否为UTC，Secret Key是否完整复制。

第五部分：常见问题问答

Q1：API Key申请后无法使用，提示签名错误，原因是什么？

A：最常见的原因是时间戳不一致，请确保Python代码生成的时间戳采用UTC格式（如2025-04-01T12:00:00Z），且与服务器时间偏差不超过30秒，其次检查Passphrase是否与创建API时填写的一致，如果你是第一次接触API，建议先访问欧易交易所下载官方文档,对照示例逐一排查。