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

admin 欧易中心 2026-06-12 1

目录导读

欧易交易所API接口概述
API接口申请前置条件
详细申请流程（含后台操作指引）
Python环境搭建与依赖安装
编写首个交易脚本（实战代码）
常见错误与调试技巧
安全注意事项与最佳实践
常见问题解答（FAQ）

欧易交易所API接口概述

欧易交易所（OKX）作为全球领先的数字资产交易平台，其API接口为开发者提供了程序化交易、市场数据获取、账户管理等核心功能，通过欧易交易所官网的开放接口，用户可以实现自动化交易策略，包括限价单、市价单、止损单等操作，同时支持实时行情订阅与历史数据查询，对于量化交易爱好者而言，掌握API接口申请与Python脚本编写,是进入专业交易领域的重要一步。

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

核心接口分类：

REST API：用于账户信息、订单管理、市场数据等请求-响应模式操作
WebSocket API：支持实时行情推送、交易对深度更新、订单状态变更监听

本文以REST API为切入点，详细演示从零到一完成交易脚本的完整流程，如果您尚未注册账户，建议先通过官方渠道完成注册，并下载欧易交易所下载的客户端进行基础操作熟悉。

API接口申请前置条件

在开始申请之前,请确认满足以下条件：

实名认证账户：完成KYC二级认证（需上传身份证件及人脸识别）
绑定安全验证：至少配置谷歌验证器（Google Authenticator）或短信验证
资金存入：账户内保留足够用于测试的交易对余额（推荐使用USDT或BTC）
了解API权限范围：明确你需要交易、查看或提币的权限，避免过度授权

安全提示：请勿将API密钥泄露给第三方，建议为每个交易脚本单独创建子API（支持绑定IP白名单）。

详细申请流程（含后台操作指引）

第一步：登录欧易官网后台

访问欧易交易平台，点击右上角“登录”进入个人账户，若尚未注册，可通过“注册”按钮完成手机号或邮箱绑定。

第二步：进入API管理页面

登录后，将鼠标移动至页面右上角的头像图标，在弹出菜单中找到“API管理”入口（通常位于“账户设置”下拉菜单中），部分新版界面可能直接显示“API”按钮,点击进入管理控制台。

第三步：创建API密钥

点击“创建API”按钮
填写API名称（如“Python交易脚本1号”）
选择权限类型：
- 读取权限：获取账户资产、订单状态
- 交易权限：下单、撤单操作
- 提币权限：谨慎开启（非必要不建议勾选）
设置IP白名单（推荐绑定服务器或本地公网IP，增强安全性）
提交后，系统将生成 API Key 和 Secret Key，请立即安全保存（页面仅展示一次,关闭后无法再次查看）

第四步：验证API可用性

创建完成后，可通过官方提供的“测试连接”功能或直接使用Python发送简单请求来验证，若返回HTTP状态码200,则表示配置成功。

Python环境搭建与依赖安装

环境要求

Python 3.7及以上版本
操作系统：Windows/macOS/Linux均可
包管理工具：pip

安装必要库

pip install requests hashlib hmac base64 time json

其中requests用于发送HTTP请求，hashlib和hmac用于生成签名，time处理时间戳，json解析返回数据。

配置IDE（建议）

推荐使用VS Code或PyCharm，并安装Python插件，便于调试和代码补全，完成后，在项目根目录创建config.py文件,保存你的API凭证：

# config.py
API_KEY = '你的API Key'
SECRET_KEY = '你的Secret Key'
PASSPHRASE = '你创建API时设置的密码短语'

注意：将config.py加入.gitignore,避免上传至公开仓库。

编写首个交易脚本（实战代码）

以下脚本实现了获取账户余额并打印BTC/USDT盘口的功能。

步骤1：生成签名

欧易API的签名机制为：对请求参数按字母排序后，拼接成字符串，再使用HMAC-SHA256算法加密。

import requests
import json
import hmac
import hashlib
import base64
import time
from config import API_KEY, SECRET_KEY, PASSPHRASE
def get_sign(timestamp, method, request_path, body=''):
    message = timestamp + method + request_path + body
    mac = hmac.new(bytes(SECRET_KEY, encoding='utf8'), 
                   bytes(message, encoding='utf8'), 
                   digestmod=hashlib.sha256)
    digest_base64 = base64.b64encode(mac.digest())
    return digest_base64.decode('utf-8')

步骤2：封装请求函数

def okx_request(method, request_path, body=''):
    timestamp = str(int(time.time() * 1000))
    sign = get_sign(timestamp, method, request_path, body)
    headers = {
        'OK-ACCESS-KEY': API_KEY,
        'OK-ACCESS-SIGN': sign,
        'OK-ACCESS-TIMESTAMP': timestamp,
        'OK-ACCESS-PASSPHRASE': PASSPHRASE,
        'Content-Type': 'application/json'
    }
    url = 'https://www.okx.com' + request_path
    response = requests.request(method, url, headers=headers, data=body)
    return response.json()

步骤3：获取账户资产

def get_account_balance():
    path = '/api/v5/account/balance'
    result = okx_request('GET', path)
    if result['code'] == '0':
        for asset in result['data'][0]['details']:
            print(f"币种: {asset['ccy']}, 可用余额: {asset['availBal']}")
    else:
        print("请求失败:", result['msg'])
if __name__ == '__main__':
    get_account_balance()

运行脚本后,你将看到账户中各币种的可用余额。

步骤4：下单交易（市价买入）

def place_market_order(inst_id='BTC-USDT', side='buy', sz='0.001'):
    body = {
        'instId': inst_id,
        'tdMode': 'cash',  # 现货交易模式
        'side': side,
        'ordType': 'market',
        'sz': sz
    }
    path = '/api/v5/trade/order'
    result = okx_request('POST', path, json.dumps(body))
    print(result)

风险提示：测试时请使用小额资金，建议先使用sz='0.00001'（最小交易单位）验证流程。