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

admin 欧易中心 2026-06-21 4

目录导读

欧易交易所API接口简介与申请流程
Python环境搭建与依赖库安装
获取API密钥与安全配置
编写第一个Python交易脚本：行情数据获取
进阶功能：下单与订单管理
常见问题与问答（FAQ）
总结与风险提示

欧易交易所API接口简介与申请流程

欧易交易所（OKX）作为全球领先的数字资产交易平台，提供了功能强大的API接口，支持用户通过程序化方式进行行情查询、交易执行、资产管理等操作，对于希望实现自动化交易的投资者来说，掌握API接口的申请与使用是入门关键。

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

申请步骤：

登录欧易交易所官网（建议使用 https://oe-okor.com.cn/ 访问），完成账号注册与实名认证（KYC二级认证）。
进入“API管理”页面，点击“创建API”。
选择API类型（交易API/读取API/统一账户API），推荐选择“交易API”以获得完整权限。
设置权限标签（如：读取、交易、提币），建议勾选“读取”和“交易”两项，提币权限默认关闭以保障安全。
完成身份验证（短信+邮箱+谷歌验证码），生成API Key与Secret Key。

注意：API密钥仅显示一次，务必妥善保管在本地文件或密码管理器中，切勿以明文形式在网络上传输。

Python环境搭建与依赖库安装

编写交易脚本前,需准备Python 3.7+环境，并安装以下核心库：

pip install requests hashlib hmac base64 json time

建议安装python-dotenv库管理密钥，避免代码中硬编码敏感信息：

pip install python-dotenv

环境验证：

import requests
print(requests.__version__)  # 输出类似 2.31.0 即成功

获取API密钥与安全配置

创建.env文件存放密钥（需添加到.gitignore避免泄露）：

API_KEY=你的API_KEY
SECRET_KEY=你的SECRET_KEY
PASSPHRASE=你的交易密码

在Python脚本中加载：

import os
from dotenv import load_dotenv
load_dotenv()
api_key = os.getenv('API_KEY')
secret_key = os.getenv('SECRET_KEY')
passphrase = os.getenv('PASSPHRASE')

安全提醒： 不要把密钥直接写在代码中；定期轮换API密钥；使用IP白名单限制访问来源。

编写第一个Python交易脚本：行情数据获取

下面是一个完整的脚本示例,用于获取BTC/USDT的当前价格（即ticker数据）：

import requests
import json
import time
import hmac
import base64
import hashlib
from datetime import datetime
# 基础URL（欧易交易所统一端点）
BASE_URL = 'https://oe-okor.com.cn'
def get_timestamp():
    return datetime.utcnow().isoformat()[:-3] + 'Z'
def sign_request(method, request_path, body=''):
    timestamp = get_timestamp()
    message = timestamp + method + request_path + body
    mac = hmac.new(bytes(secret_key, encoding='utf8'), bytes(message, encoding='utf-8'), digestmod='sha256')
    d = mac.digest()
    return base64.b64encode(d).decode()
def get_ticker(symbol='BTC-USDT'):
    request_path = f'/api/v5/market/ticker?instId={symbol}'
    method = 'GET'
    headers = {
        'OK-ACCESS-KEY': api_key,
        'OK-ACCESS-SIGN': sign_request(method, request_path),
        'OK-ACCESS-TIMESTAMP': get_timestamp(),
        'OK-ACCESS-PASSPHRASE': passphrase,
        'Content-Type': 'application/json'
    }
    response = requests.get(BASE_URL + request_path, headers=headers)
    if response.status_code == 200:
        data = response.json()
        if data['code'] == '0':
            ticker = data['data'][0]
            print(f"交易对: {ticker['instId']}")
            print(f"最新价: {ticker['last']}")
            print(f"24小时涨跌幅: {ticker['change24h']}%")
            return ticker
        else:
            print(f"API错误: {data['msg']}")
    else:
        print(f"HTTP错误: {response.status_code}")
    return None
# 运行测试
if __name__ == '__main__':
    get_ticker('ETH-USDT')

运行结果示例：

交易对: ETH-USDT  
最新价: 2563.42  
24小时涨跌幅: 2.35%

进阶功能：下单与订单管理

实现市价买入0.01 BTC的脚本：

def place_order(symbol, side, sz, ord_type='market'):
    request_path = '/api/v5/trade/order'
    method = 'POST'
    body = json.dumps({
        'instId': symbol,
        'tdMode': 'cash',
        'side': side,
        'ordType': ord_type,
        'sz': str(sz)
    })
    headers = {
        'OK-ACCESS-KEY': api_key,
        'OK-ACCESS-SIGN': sign_request(method, request_path, body),
        'OK-ACCESS-TIMESTAMP': get_timestamp(),
        'OK-ACCESS-PASSPHRASE': passphrase,
        'Content-Type': 'application/json'
    }
    response = requests.post(BASE_URL + request_path, headers=headers, data=body)
    return response.json()
# 市价买入0.01 BTC
order_result = place_order('BTC-USDT', 'buy', 0.01)
print(order_result)

注意： 市价单以当前市场最优价格成交，最小交易数量因交易对而异（BTC-USDT最小0.0001）。

常见问题与问答（FAQ）

Q1：申请API时提示“实名认证未完成”？
A：需完成欧易交易所KYC二级认证（上传身份证+人脸识别），登录官网欧易交易所官网后进入“个人中心-身份认证”，按指引操作。

Q2：为什么运行脚本返回“Invalid Sign”？
A：常见原因有：服务器时间与本地时间偏差超过30秒；Secret Key复制多出空格；passphrase配置错误，请检查代码中的时间戳生成逻辑与密钥准确性。

Q3：如何获取历史K线数据？
A：使用/api/v5/market/history-candles接口，传入instId、bar（时间粒度，如1m/5m/1H）和limit参数，示例请求：
https://oe-okor.com.cn/api/v5/market/history-candles?instId=BTC-USDT&bar=1H&limit=10

Q4：Python脚本中如何避免高频请求被限制？
A：欧易交易所API存在频率限制（REST API每2秒最多20次请求），建议在循环中添加time.sleep(0.5)实现限流，或使用WebSocket接口获取实时数据。

Q5：脚本交易存在哪些风险？
A：主要风险包括：市场剧烈波动导致滑点、网络延迟造成的订单延迟、API密钥泄露带来的资产损失、程序逻辑错误触发异常交易，请务必使用模拟盘测试，并设置止损风控。