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

admin ok快讯 2026-06-28 2

目录导读

第一章：欧易交易所API基础概览
了解API功能、用途及申请前的准备工作
第二章：欧易API接口申请详细步骤
从注册到密钥获取的完整流程解析
第三章：Python交易脚本开发环境配置
安装库、设置请求头与签名算法
第四章：编写简单的交易脚本实战
行情获取、下单与订单管理代码示例
第五章：常见问题与安全注意事项
API权限控制、错误处理及合规策略
问答专区
针对高频问题的深度解答

第一章：欧易交易所官网API基础概览

欧易交易所（OKX）作为全球领先的数字资产交易平台，其欧易API接口为开发者提供了程序化交易、数据抓取和资产管理的能力，通过API，用户可以自动化执行买卖操作，避免人工盯盘的情绪影响，在申请前,需先完成以下准备：

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

注册欧易交易所账户：确保账户完成高级实名认证（KYC2级）,这是API功能激活的前提。
了解API权限分类：欧易API分为“读取”“交易”“提币”三类，建议新手仅开启“读取”和“交易”权限,提币权限需单独申请且风险较高。
熟悉官方文档结构：欧易API REST接口基于HTTPS，响应格式为JSON，所有请求需包含时间戳、签名等验证字段，建议用户通过欧易交易所下载获取最新版本客户端,确保开发环境兼容性。

第二章：欧易API接口申请详细步骤

步骤1：登录欧易交易所官网

访问欧易官网（ox-okbb.com.cn），进入“个人中心”找到“API管理”模块，若未绑定谷歌验证器，系统会弹出安全提示,请先完成双重验证配置。

步骤2：创建API密钥

点击“创建API密钥”，填写标签名称（如“PythonBot”），选择权限范围：勾选“读取”和“交易”，部分高阶功能如“模拟交易”需在测试网申请,建议初期先使用主网。

步骤3：获取密钥信息

提交后，系统会生成API Key和Secret Key，注意：Secret Key仅显示一次，务必保存到安全位置（建议加密存储），同时复制Passphrase（自定义密码短语）,该参数在签名时使用。

步骤4：测试连接

使用Postman或curl工具测试接口连通性：
curl -X GET "https://ox-okbb.com.cn/api/v5/market/ticker?instId=BTC-USDT" -H "OK-ACCESS-KEY:你的API_KEY" -H "OK-ACCESS-SIGN:签名" -H "OK-ACCESS-TIMESTAMP:时间戳" -H "OK-ACCESS-PASSPHRASE:密码短语"
若返回市场行情数据，则申请成功，注意：签名算法需参考官方文档，否则会报“401 Unauthorized”错误。

第三章：Python交易脚本开发环境配置

1 安装必需库

在Python 3.8+环境中安装以下依赖：

pip install requests pandas ccxt

其中ccxt是统一加密货币交易所API的库，可简化签名生成步骤，但若需精细控制，建议直接使用requests构建请求。

2 配置请求头（以直接调用REST接口为例）

import requests
import json
import time
import hmac
import base64
import hashlib
api_key = "你的API_KEY"
secret_key = "你的Secret_Key"
passphrase = "你的Passphrase"
# 生成签名
def get_sign(timestamp, method, request_path, body):
    message = timestamp + method + request_path + (body if body else "")
    mac = hmac.new(bytes(secret_key, encoding='utf8'), bytes(message, encoding='utf-8'), digestmod=hashlib.sha256)
    d = mac.digest()
    return base64.b64encode(d).decode()

3 封装请求函数

def request_okx(method, path, params=None):
    base_url = "https://ox-okbb.com.cn"
    timestamp = str(int(time.time() * 1000))
    body = json.dumps(params) if params else ""
    sign = get_sign(timestamp, method, path, body)
    headers = {
        "OK-ACCESS-KEY": api_key,
        "OK-ACCESS-SIGN": sign,
        "OK-ACCESS-TIMESTAMP": timestamp,
        "OK-ACCESS-PASSPHRASE": passphrase,
        "Content-Type": "application/json"
    }
    if method == "GET":
        response = requests.get(base_url+path, headers=headers, params=params)
    else:
        response = requests.post(base_url+path, headers=headers, data=body)
    return response.json()

第四章：编写简单的交易脚本实战

1 获取BTC/USDT实时行情

def get_ticker():
    path = "/api/v5/market/ticker"
    params = {"instId": "BTC-USDT"}
    data = request_okx("GET", path, params)
    if data["code"] == "0":
        print(f"最新价: {data['data'][0]['last']}")
        print(f"24h涨跌幅: {data['data'][0]['change24h']}")
    else:
        print("请求失败:", data["msg"])

2 市价买入0.01个BTC

def market_buy():
    path = "/api/v5/trade/order"
    params = {
        "instId": "BTC-USDT",
        "tdMode": "cash",      # 现货交易
        "side": "buy",
        "ordType": "market",   # 市价单
        "sz": "0.01"           # 数量
    }
    data = request_okx("POST", path, params)
    if data["code"] == "0":
        print(f"订单ID: {data['data'][0]['ordId']}")
        print("持仓状态:", data['data'][0]['state'])  # "live"表示已成交
    else:
        print("下单失败:", data["msg"])

3 查询未成交订单

def get_pending_orders():
    path = "/api/v5/trade/orders-pending"
    params = {"instType": "SPOT"}
    data = request_okx("GET", path, params)
    if data["code"] == "0":
        for order in data["data"]:
            print(f"订单{order['ordId']}: {order['side']} {order['sz']} {order['instId']}")
    else:
        print("查询失败")

4 完整交易循环脚本示例

import time
def trading_loop():
    while True:
        ticker = get_ticker()
        price = float(ticker['data'][0]['last'])
        if price < 30000:  # 简单策略：价格低于3万USDT时买入
            market_buy()
            print("已执行买入")
        time.sleep(60)  # 每分钟检查一次

注意：此脚本仅为教学演示，实际交易需加入错误重试、资金管理、止损逻辑等，建议先在欧易交易所下载的模拟盘测试。