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

admin ok 2026-05-25 1

目录导读

欧易API接口申请前的准备工作
欧易交易所官网API密钥申请步骤详解
Python环境搭建与依赖库安装
编写第一个交易脚本：获取账户信息
实现自动下单：限价单与市价单示例
常见问题答疑（FAQ）

欧易API接口申请前的准备工作

在开始教程之前,你需要确保已经拥有一个欧易交易所官网的注册账号，并且完成了身份认证（KYC），API接口是程序化交易的核心，通过它你可以实现自动买卖、查询余额、获取实时行情等操作。

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

注意事项：

请使用稳定的网络环境访问欧易交易所官网
建议使用二次验证（Google Authenticator）保护账户安全
欧易交易所下载官方APP后,同样支持API管理功能

在正式申请前,你需要准备以下材料：

已认证的欧易账户
用于接收API密钥的邮箱（通常与注册邮箱一致）
本地安装的Python 3.7以上版本（推荐3.9或3.10）

欧易交易所官网API密钥申请步骤详解

步骤1：登录并进入API管理页面

访问欧易交易所官网,点击右上角“登录”
登录后,将鼠标悬停在用户名处，选择“API管理”
若首次使用,系统会提示安全验证（需完成邮箱+手机验证）

步骤2：创建新的API密钥

点击“创建API Key”按钮
输入API名称（Python交易脚本”）
选择权限：建议勾选“读取”“交易”“提现”（根据需求谨慎勾选提现权限）
输入资金密码（部分账户需要）
完成二次验证

注意： 生成后请立即复制 API Key 和 Secret Key，关闭页面后将无法再次查看Secret Key，建议将密钥保存在本地加密文件中。

步骤3：设置IP白名单（推荐）

为防止密钥泄露后被滥用,你可以限制只有特定IP地址才能使用该API，在API详情页中，点击“设置IP白名单”，输入你运行脚本的服务器的公网IP，最多支持5个IP地址。

步骤4：下载示例代码（可选）

欧易交易所官网提供了多语言SDK示例,包括Python、JavaScript、Java等，你可以从官方文档仓库下载，但注意官方示例通常需要自行修改配置。

Python环境搭建与依赖库安装

安装Python与pip

如果你尚未安装Python,请从python.org下载，安装时务必勾选“Add Python to PATH”。

验证安装：

python --version
pip --version

安装所需依赖库

我们需要用到两个核心库：

requests：用于发送HTTP请求
hmac / hashlib：用于签名生成（Python内置库，无需额外安装）

安装requests：

pip install requests

如果你的Python环境较旧,建议同时安装：

pip install python-dotenv  # 用于管理环境变量

创建项目目录与配置文件

在桌面或某个工作目录下创建文件夹 okx_trading，并在其中新建两个文件：

config.py：存储API密钥（注意切勿提交到公共仓库）
trade_bot.py：主交易脚本

config.py示例：

API_KEY = "你的API Key"
SECRET_KEY = "你的Secret Key"
PASSPHRASE = "你在欧易设置的资金密码"  # 部分账户需要
BASE_URL = "https://o1-okor.com.cn"  # 欧易交易所官网API端点

编写第一个交易脚本：获取账户信息

现在我们来编写最简单的API调用——获取账户余额，通过这个脚本，你可以验证密钥是否配置正确。

trade_bot.py 完整代码

import requests
import hmac
import hashlib
import base64
import time
import json
from config import API_KEY, SECRET_KEY, PASSPHRASE, BASE_URL
def get_okx_signature(timestamp, method, request_path, body=""):
    # 生成签名
    message = timestamp + method + request_path + body
    mac = hmac.new(bytes(SECRET_KEY, encoding='utf-8'), bytes(message, encoding='utf-8'), 
                   digestmod=hashlib.sha256).digest()
    return base64.b64encode(mac).decode()
def get_account_balance():
    path = "/api/v5/account/balance"
    timestamp = str(time.time())
    signature = get_okx_signature(timestamp, "GET", path)
    headers = {
        "OK-ACCESS-KEY": API_KEY,
        "OK-ACCESS-SIGN": signature,
        "OK-ACCESS-TIMESTAMP": timestamp,
        "OK-ACCESS-PASSPHRASE": PASSPHRASE,
        "Content-Type": "application/json"
    }
    response = requests.get(BASE_URL + path, headers=headers)
    return response.json()
# 执行测试
if __name__ == "__main__":
    result = get_account_balance()
    print("账户余额信息：", json.dumps(result, indent=2))

运行脚本：

python trade_bot.py

如果返回{"code":"0","data":[...]}，说明API连接成功，此时你已经成功迈出了程序化交易的第一步。

常见错误排查：

若返回code: 50100，检查API权限是否勾选“读取”
若返回code: 50103，检查签名算法是否正确

实现自动下单：限价单与市价单示例

掌握了基础调用后,我们来实现一个简单的自动下单功能，以下示例演示如何通过欧易API接口发送限价买单。

限价买入BTC示例

def place_limit_order(symbol, side, price, size):
    path = "/api/v5/trade/order"
    timestamp = str(time.time())
    body = {
        "instId": symbol,      # "BTC-USDT"
        "tdMode": "cash",      # 现货交易
        "side": side,          # "buy" 或 "sell"
        "ordType": "limit",    # 限价单
        "px": str(price),      # 价格，需转为字符串
        "sz": str(size)        # 数量
    }
    body_json = json.dumps(body)
    signature = get_okx_signature(timestamp, "POST", path, body_json)
    headers = {
        "OK-ACCESS-KEY": API_KEY,
        "OK-ACCESS-SIGN": signature,
        "OK-ACCESS-TIMESTAMP": timestamp,
        "OK-ACCESS-PASSPHRASE": PASSPHRASE,
        "Content-Type": "application/json"
    }
    response = requests.post(BASE_URL + path, headers=headers, data=body_json)
    return response.json()
# 调用示例（注意：价格与数量须符合最小交易单位）
order_result = place_limit_order("BTC-USDT", "buy", 30000.0, 0.001)
print("订单结果：", order_result)