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

admin ok快讯 2026-06-24 1

目录导读

欧易API接口申请全流程
- 账户注册与安全设置
- 创建API密钥与权限配置
- 常见问题与权限验证
Python交易脚本开发环境搭建
- 所需库安装与版本确认
- 基础网络请求封装
- 签名生成算法详解
编写第一个自动交易脚本
- 获取实时行情数据
- 执行市价与限价订单
- 查询账户资产与历史记录
实战：基于移动平均线的自动交易策略
- 策略逻辑设计
- 定时任务与循环监控
- 错误处理与日志记录
高频交易与风控注意事项
- 速率限制与请求优化
- 资金安全与密钥管理
- 常见异常场景应对

欧易API接口申请全流程

在开始编写交易脚本之前，首先需要申请欧易交易所的API接口，请前往欧易交易所下载并完成账户注册，登录后，进入“账户”->“API管理”页面，点击“创建新的API密钥”，选择“交易”权限，建议同时开启“读取”和“交易”两项，但注意不要开启“提现”权限以防止资产损失。

问：创建API密钥时，是否需要绑定IP白名单？
答：强烈建议绑定IP白名单，只允许您自己的服务器IP访问API，即使密钥泄露，攻击者也无法利用，若您使用动态IP，可先勾选“无IP限制”,但后续务必在稳定环境后添加白名单。

完成创建后，您将获得api_key和secret_key两个关键参数，请将secret_key保存在安全位置，例如环境变量或加密配置文件，切勿直接硬编码在脚本中，建议定期更换密钥,并监控API使用日志。

Python交易脚本开发环境搭建

使用Python编写交易脚本需要安装requests和hmac库（Python内置的hashlib与time库足够完成签名计算）,在命令行执行：

pip install requests

若您需要处理JSON格式数据，通常不需要额外安装,建议使用虚拟环境管理依赖。

问：为什么需要使用hmac进行签名？
答：欧易API要求每个请求携带基于secret_key和时间戳的签名，防止请求被篡改。hmac结合SHA256算法生成唯一签名,服务端验证通过后才会执行交易指令。

以下是基础请求封装代码片段：

import requests
import time
import hmac
import hashlib
import base64
api_key = "您的API_KEY"
secret_key = b"您的SECRET_KEY"
base_url = "https://ox-okbb.com.cn"
def get_sign(timestamp, method, request_path, body=""):
    message = str(timestamp) + method.upper() + request_path + body
    mac = hmac.new(secret_key, message.encode('utf-8'), hashlib.sha256)
    return base64.b64encode(mac.digest()).decode('utf-8')

注意：签名中的timestamp必须与请求头中的时间戳一致，且需使用UTC时间,常见错误是时区不一致导致签名失败。

编写第一个自动交易脚本

1 获取实时行情数据

首先测试API连接是否正常，使用GET请求获取BTC/USDT的当前价格：

def get_ticker(symbol="BTC-USDT"):
    request_path = f"/api/v5/market/ticker?instId={symbol}"
    timestamp = str(int(time.time() * 1000))
    sign = get_sign(timestamp, "GET", request_path, "")
    headers = {
        "OK-ACCESS-KEY": api_key,
        "OK-ACCESS-SIGN": sign,
        "OK-ACCESS-TIMESTAMP": timestamp,
        "OK-ACCESS-PASSPHRASE": "您的通行口令"
    }
    response = requests.get(base_url + request_path, headers=headers)
    return response.json()

通行口令是创建API密钥时设置的，务必牢记，如果忘记,只能删除原密钥重新生成。

2 执行市价与限价订单

以下示例展示如何以市价买入0.01个BTC：

def place_order(symbol, side, sz, ord_type="market"):
    body = {
        "instId": symbol,
        "side": side,
        "sz": sz,
        "ordType": ord_type
    }
    body_str = json.dumps(body)
    request_path = "/api/v5/trade/order"
    timestamp = str(int(time.time() * 1000))
    sign = get_sign(timestamp, "POST", request_path, body_str)
    headers = {
        "OK-ACCESS-KEY": api_key,
        "OK-ACCESS-SIGN": sign,
        "OK-ACCESS-TIMESTAMP": timestamp,
        "OK-ACCESS-PASSPHRASE": "您的通行口令",
        "Content-Type": "application/json"
    }
    response = requests.post(base_url + request_path, headers=headers, data=body_str)
    return response.json()

问：限价订单与市价订单有何区别？
答：市价订单以当前最优价格立即成交，适合快速建仓；限价订单挂单在指定价格，适合精确控制成本，欧易API支持多种订单类型，包括期权、期货等高级订单。

实战：基于移动平均线的自动交易策略

1 策略逻辑设计

简单移动平均线（SMA）策略：当短期SMA（如5分钟）上穿长期SMA（如20分钟）时买入；下穿时卖出,实现步骤如下：

每隔60秒获取最新K线数据。
计算最近5根和20根K线的收盘价均值。
比较两个均值,判断交叉信号。
根据信号调用下单函数。

2 定时任务与循环监控

使用time.sleep(60)实现轮询，但注意，实际运行时应避免阻塞，可使用threading.Timer或异步库。

import threading
def monitor():
    while True:
        kline_data = get_kline("BTC-USDT", "1m", limit=20)
        short_ma = sum([float(item[4]) for item in kline_data[-5:]]) / 5
        long_ma = sum([float(item[4]) for item in kline_data]) / 20
        if short_ma > long_ma and not position_held:
            place_order("BTC-USDT", "buy", "0.01", "market")
            position_held = True
        elif short_ma < long_ma and position_held:
            place_order("BTC-USDT", "sell", "0.01", "market")
            position_held = False
        time.sleep(60)
thread = threading.Thread(target=monitor)
thread.start()

注意：实盘交易前务必在模拟盘测试，欧易支持模拟盘环境,只需修改base_url为模拟盘地址。

高频交易与风控注意事项

1 速率限制与请求优化

欧易API对请求频率有严格限制：普通账户每秒最多10次，过度请求会导致IP被临时封禁,优化方法包括：

使用WebSocket订阅实时行情而非轮询。
批量请求合并数据。
本地缓存K线数据,减少重复调用。

问：如何查看当前速率限制使用情况？
答：每个API响应头中会返回X-RateLimit-Remaining字段，显示剩余请求次数，当接近上限时,应暂停请求并等待重置。

2 资金安全与密钥管理

绝对不要在公共代码仓库提交secret_key。
使用环境变量或加密的配置文件（如.env）存储密钥。
为API设置每日交易额度限制（如最大亏损阈值）。

3 常见异常场景应对

异常类型	可能原因	解决方案
签名失败	时间戳不一致或通行口令错误	检查系统时间同步，重新设置通行口令
订单被拒	金额不足或价格超出范围	查询账户余额，调整参数重试
连接超时	网络波动	设置重试机制，等待1-3秒后重试