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

admin 欧易中心 2026-06-29 1

目录导读

欧易API接口概述与申请流程
Python环境配置与API认证
账户信息查询脚本编写
现货交易订单实现
常见错误与FAQ问答

欧易API接口概述与申请流程

在数字货币交易领域，欧易交易所官网（oe-okor.com.cn）提供了完善的API接口，允许开发者通过程序化交易实现自动化策略，本文将以Python为例,手把手教你完成API申请并编写简单交易脚本。

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

1 API接口核心功能

欧易API支持以下核心功能：

市场数据获取（实时行情、K线数据）
账户资产查询
现货/合约订单管理
资金划转

2 申请API密钥步骤

登录欧易交易所官网后，进入“个人中心”或“API管理”页面
点击“创建API”按钮，选择权限（建议先勾选“只读”用于测试）
安全验证：需完成谷歌验证码或短信验证
成功创建后将获得：
- API Key（公开密钥）
- Secret Key（私密密钥，仅显示一次,请妥善保存）
- Passphrase（交易密码短语）

安全提示：切勿将Secret Key直接写入公开代码库,建议使用环境变量存储敏感信息。

Python环境配置与API认证

1 依赖库安装

打开终端执行以下命令：

pip install requests hashlib hmac base64

如果使用数据可视化或定时任务，可额外安装pandas和schedule。

2 编写认证基类

创建一个okx_auth.py文件,包含请求签名生成函数：

import requests
import hmac
import base64
import json
import time
from hashlib import sha256
class OKXAuth:
    def __init__(self, api_key, secret_key, passphrase):
        self.api_key = api_key
        self.secret_key = secret_key
        self.passphrase = passphrase
        self.base_url = "https://www.okx.com"
    def _generate_sign(self, timestamp, method, request_path, body):
        message = timestamp + method + request_path + (body or "")
        mac = hmac.new(
            self.secret_key.encode('utf-8'),
            message.encode('utf-8'),
            digestmod=sha256
        )
        return base64.b64encode(mac.digest()).decode('utf-8')
    def request(self, method, path, params=None):
        timestamp = str(time.time())
        body = json.dumps(params) if method == "POST" else ""
        sign = self._generate_sign(timestamp, method, path, body)
        headers = {
            "OK-ACCESS-KEY": self.api_key,
            "OK-ACCESS-SIGN": sign,
            "OK-ACCESS-TIMESTAMP": timestamp,
            "OK-ACCESS-PASSPHRASE": self.passphrase,
            "Content-Type": "application/json"
        }
        url = self.base_url + path
        if method == "GET":
            response = requests.get(url, headers=headers)
        else:
            response = requests.post(url, headers=headers, data=body)
        return response.json()

账户信息查询脚本编写

1 获取账户资产余额

以下脚本演示如何查询BTC、ETH等资产的可用余额：

# trading_bot.py
from okx_auth import OKXAuth
import os
# 从环境变量读取密钥（安全实践）
api_key = os.getenv("OKX_API_KEY")
secret_key = os.getenv("OKX_SECRET_KEY")
passphrase = os.getenv("OKX_PASSPHRASE")
okx = OKXAuth(api_key, secret_key, passphrase)
# 查询所有账户资产
result = okx.request("GET", "/api/v5/account/balance")
if result["code"] == "0":
    for asset in result["data"][0]["details"]:
        print(f"{asset['ccy']}: 可用 {asset['availBal']}")
else:
    print("查询失败:", result["msg"])

2 获取实时行情数据

获取BTC/USDT的最新价格：

ticker = okx.request("GET", "/api/v5/market/ticker?instId=BTC-USDT")
print(f"BTC最新价: {ticker['data'][0]['last']} USDT")

现货交易订单实现

1 下单函数封装

def place_order(okx, instId, side, sz, ordType="market"):
    """
    参数说明:
    instId: 交易对，如 'BTC-USDT'
    side: 'buy' 或 'sell'
    sz: 数量（币的个数）
    ordType: 'market'市价单, 'limit'限价单
    """
    params = {
        "instId": instId,
        "tdMode": "cash",  # 现货模式
        "side": side,
        "ordType": ordType,
        "sz": str(sz)
    }
    return okx.request("POST", "/api/v5/trade/order", params)

2 执行市价买入测试

# 注意：以下为测试示例，请确保账户有足够USDT资金
order_result = place_order(okx, "BTC-USDT", "buy", 0.001)
if order_result["code"] == "0":
    print("订单提交成功，订单ID:", order_result["data"][0]["ordId"])
else:
    print("下单失败:", order_result["msg"])

3 查询订单状态

order_detail = okx.request("GET", f"/api/v5/trade/order?instId=BTC-USDT&ordId={order_id}")
print("订单状态:", order_detail["data"][0]["state"])  # filled: 已成交