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

admin ok快讯 2026-05-20 2

目录导读

欧易API简介与申请准备
- 什么是欧易API？
- 申请API前的必要步骤
- 账号安全设置注意事项
欧易API接口申请详细流程
- 登录欧易官网并进入API管理页面
- 创建API密钥的权限选择
- 获取并保存API Key与Secret Key
Python环境搭建与依赖库安装
- Python版本要求与虚拟环境配置
- 安装requests、hashlib等核心库
- 验证安装是否成功
编写第一个交易脚本：获取账户信息
- 使用API签名机制构建请求头
- 调用欧易API获取余额数据
- 解析JSON响应并打印结果
进阶实战：自动下单与止盈止损脚本
- 构造市价单和限价单请求
- 实现基于移动平均线的简单策略
- 异常处理与日志记录技巧
常见问题与问答环节
- API调用频率限制如何规避？
- 签名错误导致403如何处理？
- 如何保证API密钥安全？

欧易API简介与申请准备

什么是欧易API？
欧易（OKX）API是官方提供的程序化交易接口，允许用户通过代码执行行情查询、下单、撤单、资产查询等操作，对于量化交易者、套利策略开发者以及需要自动化管理资产的用户而言,掌握API调用是核心技能之一。

申请API前的必要步骤

注册并完成身份认证（KYC Level 2以上）。
为API绑定IP白名单（建议绑定服务器IP或本地固定IP）。
开启手机验证或邮箱验证，确保账号安全。

重要提示：请勿将API密钥分享给他人，否则可能导致资产损失，若需在未登录状态下测试功能，可先访问欧易交易所下载页面获取最新官方入口。

账号安全设置注意事项

设置API权限时，若仅需读取数据，务必勾选“只读”模式。
交易权限分“币币交易”“合约交易”等，按需最小化授权。
定期更换API密钥,并在不使用交易功能时暂时禁用。

欧易API接口申请详细流程

登录欧易官网并进入API管理页面

打开欧易官网，点击右上角“个人中心” → “API”菜单。
若官网打不开，建议通过欧易交易所下载官方渠道获取最新域名。

创建API密钥的权限选择

只读权限：可查询行情、账户余额，适合监控脚本。
交易权限：支持下单、撤单等操作。
提币权限：非必要不勾选，避免API被利用盗取资产。

获取并保存API Key与Secret Key
创建成功后，页面会显示apiKey（公钥）和secretKey（私钥）。私钥仅显示一次，请立即复制并存储在安全位置（如密码管理器或离线文档），若丢失,需重新创建。

Python环境搭建与依赖库安装

Python版本要求与虚拟环境配置
推荐使用Python 3.8+版本,并创建虚拟环境隔离依赖：

python -m venv okx_api_env
source okx_api_env/bin/activate  # Linux/Mac
okx_api_env\Scripts\activate     # Windows

安装requests、hashlib等核心库

pip install requests hashlib time

requests用于发送HTTP请求；hashlib和time用于生成API签名（Python内置，无需额外安装）。

验证安装是否成功
运行以下代码,无报错即表示环境就绪：

import requests
import hashlib
import time
print("环境配置成功！")

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

使用API签名机制构建请求头
欧易API要求每个请求携带经过HMAC-SHA256签名的认证信息,以下是完整的签名生成函数：

import requests
import hashlib
import time
import base64
import json
def generate_sign(api_secret, method, request_path, body=''):
    timestamp = str(int(time.time()))
    pre_hash = timestamp + method.upper() + request_path + body
    signature = base64.b64encode(
        hmac.new(api_secret.encode('utf-8'), pre_hash.encode('utf-8'), digestmod=hashlib.sha256).digest()
    ).decode('utf-8')
    return timestamp, signature
# 配置API密钥（请替换为你的密钥）
api_key = 'your_api_key'
secret_key = 'your_secret_key'
passphrase = 'your_passphrase'  # 创建API时设置的密码短语

调用欧易API获取余额数据

def get_account_balance():
    method = 'GET'
    request_path = '/api/v5/account/balance'
    timestamp, sign = generate_sign(secret_key, method, request_path)
    headers = {
        'OK-ACCESS-KEY': api_key,
        'OK-ACCESS-SIGN': sign,
        'OK-ACCESS-TIMESTAMP': timestamp,
        'OK-ACCESS-PASSPHRASE': passphrase,
        'Content-Type': 'application/json'
    }
    base_url = 'https://www.okx.com'  # 可替换为备用域名，如通过ox-okbb.com.cn获取
    response = requests.get(base_url + request_path, headers=headers)
    return response.json()
# 执行查询
bal_data = get_account_balance()
print(json.dumps(bal_data, indent=4, ensure_ascii=False))

解析JSON响应并打印结果
若响应中包含data[0]['details']字段,即可提取各币种余额。

if bal_data['code'] == '0':
    for asset in bal_data['data'][0]['details']:
        print(f"币种: {asset['ccy']}, 可用余额: {asset['availBal']}, 总余额: {asset['eq']}")

进阶实战：自动下单与止盈止损脚本

构造市价单和限价单请求
以下示例演示如何下市价买单（用USDT购买BTC）：

def place_market_order(side, inst_id='BTC-USDT', sz='0.001'):
    method = 'POST'
    request_path = '/api/v5/trade/order'
    body = {
        'instId': inst_id,
        'tdMode': 'cash',     # 现金交易模式
        'side': side,         # 'buy' 或 'sell'
        'ordType': 'market',  # 市价单
        'sz': sz              # 数量
    }
    timestamp, sign = generate_sign(secret_key, method, request_path, json.dumps(body))
    headers = { ... }  # 同前
    response = requests.post(base_url + request_path, headers=headers, data=json.dumps(body))
    return response.json()

实现基于移动平均线的简单策略

def ma_strategy(symbol='BTC-USDT', short_period=5, long_period=10):
    # 1. 获取K线数据（简化版）
    kline = get_kline(symbol, bar='1m')
    close_prices = [float(k[4]) for k in kline['data']]
    # 2. 计算均线
    short_ma = sum(close_prices[-short_period:]) / short_period
    long_ma = sum(close_prices[-long_period:]) / long_period
    # 3. 判断信号
    if short_ma > long_ma:
        order = place_market_order('buy', symbol)
        print(f"买入信号触发，订单ID：{order['data'][0]['ordId']}")
    elif short_ma < long_ma:
        order = place_market_order('sell', symbol)
        print(f"卖出信号触发，订单ID：{order['data'][0]['ordId']}")

异常处理与日志记录技巧