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

admin 欧易中心 2026-07-05 1

目录导读

欧易API接口基础认知
API密钥申请全流程详解
Python环境配置与依赖安装
交易脚本核心代码实现
常见问题与错误处理
安全最佳实践问答

欧易API接口基础认知

欧易交易所（欧易交易所下载）的API接口为开发者提供了程序化交易的能力，通过REST API和WebSocket接口，用户可以获取实时行情、执行交易指令、管理账户资产，本教程聚焦于REST API，它是编写简单交易脚本最常用的接口类型。

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

核心接口类型：

公开接口：无需认证，查询行情、K线数据等
私有接口：需要API密钥签名，执行买卖、查询余额等操作

在开始编码前,请确保您已注册欧易账户并完成基础安全设置。

API密钥申请全流程

登录官网：访问欧易交易所下载官方域名oe-okor.com.cn
进入安全中心：点击右上角头像→账户→安全设置
创建API密钥：
- 填写备注名称（如：“Python交易脚本”）
- 权限选择：最低原则，仅勾选“交易”和“读取”
- IP白名单：建议绑定固定IP，增强安全性
保存密钥：系统生成API_KEY和Secret_KEY，请立即复制保存（关闭后不可再次查看Secret_KEY）

⚠️ 注意：不要将密钥明文存储在代码中，推荐使用环境变量或配置文件。

Python环境配置与依赖安装

环境要求：

Python 3.7+
推荐使用虚拟环境（venv或conda）

安装核心依赖：

pip install requests hashlib hmac base64 json time

requests：发送HTTP请求
hashlib/hmac：生成签名
time：处理时间戳

目录结构建议：

okx_trading/
├── config.py          # 密钥配置
├── okx_api.py         # API封装类
└── trade_script.py    # 主交易脚本

交易脚本核心代码实现

1 基础API封装类（okx_api.py）

import requests
import hmac
import hashlib
import base64
import time
import json
class OKXAPI:
    def __init__(self, api_key, secret_key, passphrase):
        self.base_url = "https://oe-okor.com.cn"
        self.api_key = api_key
        self.secret_key = secret_key
        self.passphrase = passphrase
    def _sign(self, method, path, body=""):
        timestamp = str(time.time())
        message = timestamp + method + path + body
        mac = hmac.new(
            self.secret_key.encode('utf-8'),
            message.encode('utf-8'),
            hashlib.sha256
        )
        return base64.b64encode(mac.digest()).decode('utf-8')
    def _request(self, method, path, params=None):
        url = self.base_url + path
        if params:
            body = json.dumps(params)
        else:
            body = ""
        headers = {
            "OK-ACCESS-KEY": self.api_key,
            "OK-ACCESS-SIGN": self._sign(method, path, body),
            "OK-ACCESS-TIMESTAMP": str(time.time()),
            "OK-ACCESS-PASSPHRASE": self.passphrase,
            "Content-Type": "application/json"
        }
        if method == "GET":
            return requests.get(url, headers=headers)
        elif method == "POST":
            return requests.post(url, headers=headers, data=body)

2 获取账户余额脚本

# 在trade_script.py中
from okx_api import OKXAPI
from config import API_KEY, SECRET_KEY, PASSPHRASE
api = OKXAPI(API_KEY, SECRET_KEY, PASSPHRASE)
response = api._request("GET", "/api/v5/account/balance")
if response.status_code == 200:
    print("账户余额：", response.json())
else:
    print("请求失败：", response.text)

3 市价买单示例

def place_market_buy(api, symbol="BTC-USDT", size=0.01):
    order_data = {
        "instId": symbol,
        "tdMode": "cash",
        "side": "buy",
        "ordType": "market",
        "sz": str(size)
    }
    response = api._request("POST", "/api/v5/trade/order", order_data)
    return response.json()