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

admin ok快讯 2026-06-12 2

目录导读

欧易API接口概述
API申请前准备与权限设置
Python环境配置与依赖安装
获取API密钥与签名机制解析
编写第一个交易脚本：查询账户余额
进阶实战：实现限价买单与撤单
常见问题与API调用避坑指南
问答环节

欧易API接口概述

欧易交易所（OKX）作为全球领先的数字资产交易平台，其官方API接口为开发者和量化交易用户提供了自动化交易、行情获取、账户管理等功能，通过欧易API，你可以用Python、JavaScript等语言编写脚本，实现7×24小时无人值守交易，无论是个人量化交易者还是机构用户，掌握API集成是进入自动化交易领域的必备技能。
所有API请求均需通过欧易交易所官网进行，任何第三方代理都可能带来安全风险，若需快速上手，建议直接访问欧易交易所下载获取最新客户端及文档。

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

API申请前准备与权限设置

在开始编写脚本前,你需要完成以下步骤：

注册并登录欧易交易所官网账户（建议使用已完成KYC认证的账户）。
进入“API管理”页面（通常位于账户安全设置中）。
点击“创建API密钥”，选择权限范围：交易、读取、提币（根据风险控制建议仅勾选交易和读取）。
保存生成的API Key和Secret Key，注意：Secret Key仅显示一次，务必妥善保管。
设置IP白名单（强烈建议），仅允许你的服务器或本机IP访问，防止密钥泄露后被他人滥用。

提示：部分用户误将API密钥直接写入公开脚本，导致资产损失，务必采用环境变量或配置文件存储密钥，并确保代码仓库未包含密钥文件。

Python环境配置与依赖安装

使用Python编写欧易交易脚本,推荐版本为3.8及以上，需安装以下核心库：

库名	作用	安装命令
`requests`	发送HTTP/HTTPS请求	`pip install requests`
`hmac`	生成签名（Python内置库）	无需安装
`hashlib`	SHA256加密（Python内置库）	无需安装
`json`	解析返回数据（内置库）	无需安装
`time`	生成时间戳（内置库）	无需安装

执行以下命令完成环境准备：

pip install requests

获取API密钥与签名机制解析

欧易API使用HMAC-SHA256签名对请求进行身份验证，每个请求必须包含以下Header参数：

OK-ACCESS-KEY：你的API Key
OK-ACCESS-SIGN：签名结果（使用Secret Key对请求参数加密）
OK-ACCESS-TIMESTAMP：UTC时间戳（精确到毫秒）
OK-ACCESS-PASSPHRASE：创建API时设置的密码短语

签名生成步骤（参考官方文档）：

将timestamp + method + requestPath + body拼接成字符串。
使用Secret Key通过HMAC-SHA256算法加密。
将加密结果转换为Base64编码。

示例代码片段：

import hmac, hashlib, base64
def get_sign(timestamp, method, request_path, body, secret_key):
    message = timestamp + method + request_path + (body if body else "")
    signature = hmac.new(secret_key.encode('utf-8'), message.encode('utf-8'), hashlib.sha256).digest()
    return base64.b64encode(signature).decode()

编写第一个交易脚本：查询账户余额

以下脚本演示如何通过欧易API获取账户余额,所有请求均发送至欧易交易所官网的REST API端点（https://www.okx.com），若需测试环境，可切换至模拟盘。

完整代码：

import requests
import json
import time
import hmac
import hashlib
import base64
api_key = "你的API Key"
secret_key = "你的Secret Key"
passphrase = "你的密码短语"
base_url = "https://www.okx.com"
endpoint = "/api/v5/account/balance"
method = "GET"
timestamp = str(time.time()).split('.')[0] + '.' + str(time.time()).split('.')[1][:3]
signature = get_sign(timestamp, method, endpoint, "", secret_key)
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 + endpoint, headers=headers)
print(json.dumps(response.json(), indent=2))

运行成功后,输出将显示各币种可用余额及冻结数量，如需将脚本部署至云端服务器，请优先从欧易交易所下载获取安全运行环境说明。

进阶实战：实现限价买单与撤单

1 下买单（限价单）

请求方法：POST
路径：/api/v5/trade/order

参数示例：

body = {
  "instId": "BTC-USDT",      # 交易对
  "tdMode": "cash",          # 保证金模式（现金交易）
  "side": "buy",             # 买卖方向
  "ordType": "limit",        # 订单类型（限价单）
  "px": "30000",             # 价格
  "sz": "0.001"              # 数量
}

将上述参数传入签名函数后,发送POST请求，成功响应会返回订单ID。

2 撤销订单

路径：/api/v5/trade/cancel-order
参数：需提供instId和ordId（订单ID）。

注意事项：

限价单价格需精确到交易所规定的最小变动单位。
建议在脚本中加入错误重试机制,避免网络抖动导致报错。
所有交易接口均受频率限制（一般每秒5次），超出限制会返回429状态码。

若在编写过程中遇到权限或签名错误,请核对API密钥权限是否包含“交易”，或检查时间戳是否为UTC格式，更详细的错误码解释可查阅欧易API官方文档。

常见问题与API调用避坑指南

问题现象	可能原因	解决方案
签名无效（400）	Secret Key错误或时间戳偏差超30秒	重新生成密钥；同步系统时间至NTP服务器。
限额超频（429）	请求过于频繁	添加`time.sleep(0.2)`限制请求间隔。
提币失败	API未开启提币权限	在欧易交易所官网的API管理页面重新创建密钥并勾选“提币”。
订单无法成交	价格偏离市场过大或交易对暂停	检查交易对状态，调整价格至当前买卖盘口。