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

admin okx快讯 2026-06-29 6

目录导读

欧易API接口概述
API申请与配置步骤
环境搭建：Python与必备库安装
编写第一个Python交易脚本
常见问题与解答（QA）
安全优化与注意事项
延伸阅读：自动交易策略入门

欧易API接口概述

在数字货币交易领域，欧易交易所下载提供了一套功能完善的API接口，允许开发者通过程序自动化执行交易、查询行情、管理订单等操作，无论是个人量化交易者，还是机构级做市商，都可以利用这套接口实现高效的策略执行，本文将以Python语言为例，手把手教你完成API申请、环境配置以及第一个简单交易脚本的编写。

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

欧易API支持RESTful和WebSocket两种协议，其中REST API适用于非实时性操作（如查询账户余额、下单），WebSocket则适合实时订阅行情和成交数据，本教程主要聚焦于REST API的使用,因为它易于上手且能满足大多数基础交易需求。

API申请与配置步骤

要使用欧易API，首先需要在官网注册账号并完成API密钥的申请,请按照以下步骤操作：

登录账号
前往欧易官网，登录你的账户，如果没有账号,请先完成注册与实名认证。
进入API管理页面
在用户中心找到“API管理”或“API密钥”选项,点击进入。
创建API密钥
- 点击“创建API密钥”按钮。
- 选择权限范围：推荐勾选“交易”和“读取”权限，如需提币则勾选“提现”，但为安全起见，通常不建议开启提币权限。
- 设置IP白名单（可选，但强烈建议）：只允许你信任的IP地址调用API。
- 输入资金密码（如有）及短信/邮箱验证码。
保存密钥信息
创建成功后，你会获得一个API Key和Secret Key。请务必立即保存到安全的本地文件或密码管理器中，因为Secret Key只显示一次。

注意：切勿将密钥上传至公开代码仓库或分享给他人,建议在服务器端使用环境变量或配置文件存储密钥。

环境搭建：Python与必备库安装

在编写脚本之前，需要确保Python环境已安装（推荐Python 3.8以上版本）,并安装以下依赖库：

requests：用于发起HTTP请求。
hmac、hashlib：用于签名生成。
time：生成时间戳。
json：解析返回数据。

安装命令（在终端或命令提示符中执行）：

pip install requests

其他库均为Python内置,无需额外安装。

编写第一个Python交易脚本

下面是一个完整的Python脚本示例，实现了查询账户余额的功能，你可以以此为基础，扩展出下单、撤单等交易操作。

import requests
import hmac
import hashlib
import time
import json
# 请替换为你的API Key和Secret Key
API_KEY = "你的API_KEY"
SECRET_KEY = "你的SECRET_KEY"
BASE_URL = "https://oe-okgn.com.cn/api/v5"  # 请替换为实际API域名
def get_signature(timestamp, method, request_path, body=""):
    """
    生成签名
    :param timestamp: ISO格式时间戳
    :param method: 请求方法 (GET/POST)
    :param request_path: 请求路径 (如 /account/balance)
    :param body: 请求体字符串 (POST请求时使用)
    :return: 签名字符串
    """
    message = timestamp + method + request_path + body
    mac = hmac.new(bytes(SECRET_KEY, encoding='utf8'), 
                   bytes(message, encoding='utf-8'), 
                   digestmod=hashlib.sha256)
    return mac.hexdigest()
def get_account_balance():
    """
    查询账户余额（演示权限）
    """
    method = "GET"
    request_path = "/account/balance"
    timestamp = time.strftime("%Y-%m-%dT%H:%M:%S", time.gmtime()) + ".000Z"
    signature = get_signature(timestamp, method, request_path)
    headers = {
        "OK-ACCESS-KEY": API_KEY,
        "OK-ACCESS-SIGN": signature,
        "OK-ACCESS-TIMESTAMP": timestamp,
        "OK-ACCESS-PASSPHRASE": "你的passphrase",  # 创建API时的密码短语
        "Content-Type": "application/json"
    }
    url = BASE_URL + request_path
    response = requests.get(url, headers=headers)
    if response.status_code == 200:
        data = response.json()
        print("账户余额信息：", json.dumps(data, indent=2))
    else:
        print("请求失败，状态码：", response.status_code)
        print("错误信息：", response.text)
if __name__ == "__main__":
    get_account_balance()

脚本说明

时间戳：必须使用ISO 8601格式，精确到毫秒。
签名生成：欧易使用HMAC-SHA256算法，将时间戳、请求方法、请求路径和请求体拼接后签名。
请求头：必须包含OK-ACCESS-KEY、OK-ACCESS-SIGN、OK-ACCESS-TIMESTAMP、OK-ACCESS-PASSPHRASE四项。
响应处理：成功则打印账户详情,失败则输出错误码与原因。

如果你想测试下单功能，可以将上述代码中的request_path改为/trade/order,并传递POST请求体，

order_body = {
    "instId": "BTC-USDT",
    "tdMode": "cash",
    "side": "buy",
    "ordType": "limit",
    "px": "50000",
    "sz": "0.001"
}

然后使用requests.post(url, headers=headers, data=json.dumps(order_body))发送请求。

常见问题与解答（QA）

Q1：为什么我的签名验证一直失败？
A：最常见的原因是时间戳不准确或格式错误，请确保使用UTC时间，并检查你的系统时间是否与网络时间同步。OK-ACCESS-PASSPHRASE必须与创建API密钥时设置的密码短语完全一致。

Q2：欧易API有频率限制吗？
A：是的，欧易对REST API的请求频率有限制（例如每秒最多10次），建议在脚本中加入延迟（如time.sleep(0.1)）避免触发限流，如果高频交易需求,请考虑使用WebSocket接口。

Q3：脚本运行后返回“Unauthorized”是什么原因？
A：可能原因包括：API Key无效、Secret Key错误、IP白名单未放行当前请求IP、签名算法不匹配等,请逐项检查你的配置。

Q4：如何测试脚本而不产生真实交易？
A：欧易提供了模拟盘（sandbox）环境，将基础URL改为https://oe-okgn.com.cn/sandbox/api/v5,并使用模拟盘的API密钥即可在无资金风险的环境下测试。

Q5：我可以同时运行多个交易脚本吗？
A：可以，但需注意每个API Key都有独立的频率限制，如果多脚本共用同一密钥，请确保总请求数不超过限制，建议为不同策略分配不同的API Key。

安全优化与注意事项

密钥管理
- 使用环境变量存储密钥，避免硬编码在脚本中。
- 定期更换API Key和Secret Key。
- 启用IP白名单,只允许特定服务器访问。
错误处理
- 增加重试机制，应对网络波动。
- 记录日志，方便排查问题。
- 设置止损逻辑,防止程序异常导致亏损。
合规提醒
- 自动交易需遵守所在国家/地区的法律法规。
- 使用交易所API前,请仔细阅读官方文档和条款。