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

admin 欧易中心 2026-06-24 2

目录导读

引言：欧易API的潜力与价值
前置准备：申请欧易API接口的完整流程
- 账号注册与安全设置
- 创建API密钥并配置权限
- 理解API文档与调用规则
Python环境搭建与核心库安装
实战：编写一个简单的交易脚本
- 连接欧易服务器与身份验证
- 获取实时市场行情数据
- 实现限价单与市价单下单
- 查询资产余额与订单状态
常见问题与解决策略
问答环节：新手最关心的5个问题

欧易API的潜力与价值

欧易交易所（OKX）作为全球领先的数字资产交易平台，其API接口为量化交易者和程序化操作者打开了自动化的大门，通过欧易API，你可以用Python等编程语言直接与交易所后台交互，实现行情监控、自动买卖、策略回测等功能，本教程将手把手教你从零开始申请欧易API接口，并编写一个可用于实际操作的简单Python交易脚本，无论你是量化新手还是有经验的开发者，都能通过本文快速上手，如果你尚未下载客户端，可先访问欧易交易所下载完成注册与安装。

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

前置准备：申请欧易API接口的完整流程

账号注册与安全设置

你需要拥有一个欧易账号，若没有，请前往oe-okor.com.cn完成注册，并进行实名认证（KYC）,这是申请API的基础条件。
登录后，强烈建议开启二次验证（Google Authenticator或短信验证）,以保障API密钥安全。

创建API密钥并配置权限

在欧易官网右上角点击“账户” → “API”,进入管理页面。
点击“新建API”，输入备注名称（如“Python交易脚本”）。
权限设置：根据需求勾选“读取”、“交易”、“资金”等权限，若仅用于行情分析，只需“读取”权限；若需要下单，则需勾选“交易”权限。切勿勾选“提币”权限,避免资金被盗风险。
输入资金密码（若已设置）和二次验证码，提交后你将获得API Key 和 Secret Key，请立即复制并安全保存，Secret Key仅显示一次,丢失后无法找回。

理解API文档与调用规则

欧易提供了完整的REST API和WebSocket API文档,建议先阅读官方文档的核心规则：

请求头：需包含OK-ACCESS-KEY、OK-ACCESS-SIGN、OK-ACCESS-TIMESTAMP、OK-ACCESS-PASSPHRASE。
签名算法：使用HMAC-SHA256对请求参数进行加密。
基础URL：REST API地址为https://www.okx.com（现货）或对应子域名。

Python环境搭建与核心库安装

确保你的Python版本为3.7及以上，打开终端或命令行,安装以下必需库：

pip install requests
pip install pandas
pip install python-dotenv  # 用于管理敏感信息

建议在项目根目录创建.env文件,存储API密钥：

API_KEY=your_api_key_here
SECRET_KEY=your_secret_key_here
PASSPHRASE=your_passphrase_here

然后使用dotenv加载变量,避免泄露密钥。

实战：编写一个简单的交易脚本

以下脚本将演示如何连接欧易API，获取比特币（BTC）当前价格,并执行一笔小额市价买入订单。

1 连接服务器与身份验证

我们需要一个签名工具类：

import requests
import time
import hmac
import hashlib
import base64
from dotenv import load_dotenv
import os
load_dotenv()
class OKXAPI:
    def __init__(self):
        self.api_key = os.getenv("API_KEY")
        self.secret_key = os.getenv("SECRET_KEY")
        self.passphrase = os.getenv("PASSPHRASE")
        self.base_url = "https://www.okx.com"
    def _sign(self, timestamp, method, request_path, body=""):
        message = timestamp + method + request_path + body
        mac = hmac.new(bytes(self.secret_key, encoding='utf8'), bytes(message, encoding='utf-8'), digestmod='sha256')
        return base64.b64encode(mac.digest())
    def _header(self, method, request_path, body=""):
        timestamp = str(time.time())
        sign = self._sign(timestamp, method, request_path, body)
        return {
            "OK-ACCESS-KEY": self.api_key,
            "OK-ACCESS-SIGN": sign,
            "OK-ACCESS-TIMESTAMP": timestamp,
            "OK-ACCESS-PASSPHRASE": self.passphrase,
            "Content-Type": "application/json"
        }

2 获取实时行情数据

添加获取市场行情的方法：

    def get_ticker(self, inst_id="BTC-USDT"):
        path = f"/api/v5/market/ticker?instId={inst_id}"
        response = requests.get(self.base_url + path, headers=self._header("GET", path))
        return response.json()

调用示例：

api = OKXAPI()
ticker = api.get_ticker("BTC-USDT")
print("当前BTC价格:", ticker['data'][0]['last'])

3 实现限价单与市价单下单

接下来是下单功能,这里实现市价买入：

    def place_order(self, inst_id="BTC-USDT", side="buy", ord_type="market", sz="0.001"):
        body = {
            "instId": inst_id,
            "tdMode": "cash",  # 现货交易
            "side": side,
            "ordType": ord_type,
            "sz": sz
        }
        path = "/api/v5/trade/order"
        body_str = json.dumps(body)
        response = requests.post(self.base_url + path, headers=self._header("POST", path, body_str), data=body_str)
        return response.json()

注意：sz表示数量，对于市价单，sz指买入的USDT金额（如果计价币种是USDT）或币的数量（如果计价币种为币），具体规则查阅文档，若你想从欧易交易所下载的界面确认参数,可参考客户端内的交易规则。

4 查询资产余额与订单状态

查询账户余额：

    def get_account_balance(self, ccy="USDT"):
        path = f"/api/v5/account/balance?ccy={ccy}"
        response = requests.get(self.base_url + path, headers=self._header("GET", path))
        return response.json()

查询订单状态：

    def get_order(self, inst_id="BTC-USDT", ord_id=""):
        path = f"/api/v5/trade/order?instId={inst_id}&ordId={ord_id}"
        response = requests.get(self.base_url + path, headers=self._header("GET", path))
        return response.json()

将上述代码整合，你就可以创建一个完整的交易脚本，写一个trade.py，先检查余额，若USDT充足则买入0.001 BTC,然后打印订单状态。

常见问题与解决策略

签名错误（401）：检查时间戳是否与服务端偏差过大（建议使用NTP同步时间），或Secret Key是否正确。
权限不足（403）：检查API权限勾选是否完整，特别是“交易”权限。
订单被拒（400）：检查交易对名称、数量精度、模式（cash/margin）是否正确。
频率限制：REST API每秒最多请求20次，超限会被临时封禁，建议加入睡眠时间（time.sleep(0.1)）。
数据传输安全：始终使用HTTPS，不要将Secret Key硬编码到代码中,使用环境变量或加密存储。

排查问题时，可结合oe-okor.com.cn的在线客服或开发者社区寻求帮助。

问答环节：新手最关心的5个问题

Q1：申请欧易API需要什么条件？
A1：需完成欧易账号注册并通过KYC实名认证，然后登录网页端进入API管理页面创建，如果你尚未拥有账号，可先完成欧易交易所下载。

Q2：Python脚本能同时管理多个账户吗？
A2：可以，只需分别存储每个账户的API密钥，创建多个API实例，并通过轮询或异步方式访问,但需要注意IP限制和频率控制。

Q3：如何避免脚本在交易时产生滑点？
A3：建议使用限价单（limit order）而非市价单，通过获取深度数据（order book）设定合理的限价价格，并设置postOnly参数确保订单不会吃单。

Q4：API调用的时间戳必须精确到秒吗？
A4：必须使用Unix时间戳（秒级或毫秒级），且与服务端时间误差不能超过30秒，建议使用time.time()并对时。

Q5：脚本部署在云服务器上有额外的安全要求吗？
A5：强烈建议将服务器IP地址添加到欧易API的“白名单”中（在API设置页面开启），并定期轮换密钥，同时关闭服务器上不必要的端口,使用防火墙和密钥登录。

通过以上教程，你已经掌握了从申请欧易API接口到编写Python交易脚本的完整流程，量化交易之路始于第一步，建议先在模拟盘或小额资金上测试你的脚本，熟悉所有API细节后再逐步放大交易规模，持续学习并完善你的策略,未来甚至可以在此基础上构建复杂的算法交易系统。

标签：欧易API Python交易