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

admin ok 2026-07-06 2

目录导读

欧易API接口概述与核心功能
欧易API接口申请步骤详解
Python环境搭建与依赖库安装
编写第一个欧易交易脚本
常见问题与问答（FAQ）
安全注意事项与后续优化

欧易API接口概述与核心功能

欧易交易所作为全球领先的数字资产交易平台,为开发者提供了完善的API接口，支持现货、合约、期权等多种交易类型，通过调用欧易API接口，用户可以实现自动化交易策略、市场数据获取、账户管理等核心功能，对于量化交易者而言，掌握欧易API的调用方法是实现高效交易的基础，本文将以Python语言为例，详细演示从注册API到编写简单交易脚本的全流程。

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

欧易API接口申请步骤详解

1 注册与登录

你需要拥有一个欧易交易所账户,如果尚未注册，请前往欧易交易所下载完成注册并完成KYC认证，认证通过后，登录到账户后台。

2 创建API密钥

登录后,点击右上角头像，选择“API管理”菜单。
点击“创建API”按钮，系统会弹出设置页面。
填写API名称,建议使用英文或数字组合（如“TradeBot_V1”）。
权限设置：根据需求勾选“读取”、“交易”或“提现”权限。注意：为安全考虑，不要勾选“提现”权限。
设置IP白名单：建议绑定固定IP，避免密钥被盗用。
完成安全验证（邮箱或短信验证码），点击确认生成API Key、Secret Key和Passphrase。

3 保存密钥

生成后,立即将三个关键信息复制保存到安全位置：

api_key：用于身份识别
secret_key：签名密钥（不可恢复）
passphrase：API访问密码

提示：一旦关闭页面，secret_key将无法再次查看，需重新创建新的API。

Python环境搭建与依赖库安装

1 安装Python

确保本地已安装Python 3.6以上版本，可通过命令行输入python --version检查。

2 安装依赖库

我们需要requests库发送HTTP请求，hashlib和hmac用于签名计算，推荐使用pip安装：

pip install requests hmac hashlib base64

为了处理时间戳,建议安装datetime库（Python自带）。

编写第一个欧易交易脚本

1 创建基础连接模块

以下代码实现了欧易API的签名生成与请求发送功能。

import requests
import hmac
import hashlib
import base64
import datetime
import json
class OKXAPI:
    def __init__(self, api_key, secret_key, passphrase):
        self.base_url = "https://www.okx.com"
        self.api_key = api_key
        self.secret_key = secret_key
        self.passphrase = passphrase
    def _get_timestamp(self):
        # 生成ISO8601格式时间戳
        now = datetime.datetime.utcnow()
        return now.isoformat("T")[:-3] + "Z"
    def _sign(self, timestamp, method, request_path, body=""):
        # 签名生成逻辑
        message = timestamp + method.upper() + request_path + body
        mac = hmac.new(
            bytes(self.secret_key, encoding='utf-8'),
            bytes(message, encoding='utf-8'),
            digestmod=hashlib.sha256
        )
        return base64.b64encode(mac.digest()).decode('utf-8')
    def get_request(self, request_path):
        # GET请求
        timestamp = self._get_timestamp()
        signature = self._sign(timestamp, "GET", request_path)
        headers = {
            "OK-ACCESS-KEY": self.api_key,
            "OK-ACCESS-SIGN": signature,
            "OK-ACCESS-TIMESTAMP": timestamp,
            "OK-ACCESS-PASSPHRASE": self.passphrase,
            "Content-Type": "application/json"
        }
        response = requests.get(self.base_url + request_path, headers=headers)
        return response.json()
    def post_request(self, request_path, body):
        # POST请求
        timestamp = self._get_timestamp()
        body_str = json.dumps(body)
        signature = self._sign(timestamp, "POST", request_path, body_str)
        headers = {
            "OK-ACCESS-KEY": self.api_key,
            "OK-ACCESS-SIGN": signature,
            "OK-ACCESS-TIMESTAMP": timestamp,
            "OK-ACCESS-PASSPHRASE": self.passphrase,
            "Content-Type": "application/json"
        }
        response = requests.post(self.base_url + request_path, headers=headers, data=body_str)
        return response.json()

2 获取账户余额

# 示例：获取资金账户余额
api = OKXAPI("你的api_key", "你的secret_key", "你的passphrase")
result = api.get_request("/api/v5/account/balance")
print(result)

3 下单交易脚本

以下脚本实现市价买入0.001个BTC（测试网环境建议使用模拟盘）：

def place_market_order(api, side, size, instId="BTC-USDT"):
    order_data = {
        "instId": instId,
        "tdMode": "cash",
        "side": side,
        "ordType": "market",
        "sz": str(size)
    }
    return api.post_request("/api/v5/trade/order", order_data)
# 执行买入
order_result = place_market_order(api, "buy", 0.001)
print("订单结果：", order_result)

4 运行与调试

将上述代码保存为okx_trade.py，在终端执行：

python okx_trade.py

若返回成功响应（如{"code":"0","data":[{"ordId":"123456789"}]}），则说明脚本正常运作。

常见问题与问答（FAQ）

Q1：申请API时提示“IP白名单校验失败”怎么办？
A：请确认当前运行脚本的服务器IP已添加至白名单，如果使用动态IP，可临时允许所有IP（0.0.0.0/0），但建议生产环境绑定固定IP。

Q2：交易脚本报错“签名错误”如何排查？
A：常见原因有：时间戳未使用UTC、secret_key包含多余空格、请求path写错，请检查_sign方法中的时间戳格式是否与官方一致，且密钥无误。

Q3：如何获取欧易官方最新的API文档？
A：建议访问欧易开发者中心获取最新接口说明，并对照本文代码进行微调。

Q4：脚本能否用于实盘交易？
A：可以，但强烈建议先在模拟环境（测试网）充分测试，实盘时先以极小仓位验证逻辑，并做好止损设置。

Q5：Python脚本遇到速率限制（Rate Limit）怎么办？
A：欧易API对请求频率有限制（如每秒不超过10次），可在请求间添加time.sleep(0.1)避免频繁调用。

安全注意事项与后续优化

安全第一

密钥存储：绝对不要将API密钥硬编码在公开代码中，推荐使用环境变量读取：
```
import os
api_key = os.getenv("OKX_API_KEY")
```
权限最小化：生产环境仅勾选必要的读写权限，杜绝提现权限。
网络隔离：若使用云服务器部署，应限制只有信任IP能访问服务器。