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

admin 欧易中心 2026-05-22 1

📖 目录导读

欧易API接口简介 – 了解欧易交易所官方API的功能与价值
API接口申请前置准备 – 账号注册、身份认证与密钥生成
Python环境搭建 – 必备库安装与开发环境配置
API调用实战代码 – 从行情查询到下单交易的完整脚本
常见问题与避坑指南 – 交易脚本开发中的高频疑问解答
安全与合规注意事项 – 密钥管理、IP白名单与风控建议

欧易API接口简介

在加密货币交易领域，欧易交易所官网提供了一套功能完善的REST与WebSocket API接口，允许开发者通过程序化方式获取实时行情、查询账户资产、执行买卖操作，对于量化交易爱好者或需要自动化交易的用户而言,学会使用Python调用欧易API是提升交易效率的关键一步。

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

欧易API接口支持现货、合约、期权等多类交易品种，并提供了完整的错误码机制与限频策略，通过本次教程，你将零基础掌握如何用Python编写一个能够连接欧易交易所、获取K线数据并执行限价单的交易脚本，在进行任何真实资金操作前，建议先在欧易交易所下载测试网环境进行模拟演练。

API接口申请前置准备

1 账号注册与身份认证

访问欧易交易所官网，完成账号注册并通过KYC二级认证,API接口的创建权限通常要求账号已完成基础身份验证。

2 创建API密钥对

登录欧易账户后，进入“账户中心” → “API管理”页面：

点击“新建API”，选择交易类型（如“交易”与“读取”权限）
系统会生成 API Key、Secret Key 和 Passphrase
务必保存Secret Key到本地安全位置（关闭页面后不可再次查看）

安全提示：请为API设置IP白名单，限制只有你的服务器IP能够访问,此步骤可极大降低密钥泄露风险。

Python环境搭建

1 安装必备库

pip install requests hashlib hmac base64 json time

其中requests用于发送HTTP请求，hmac与hashlib负责生成签名。

2 创建项目文件

新建okx_trader.py文件，后续所有代码均写入该文件，推荐使用Python 3.8以上版本。

API调用实战代码

以下是一个完整的欧易API交易脚本示例，包含行情获取、账户查询与下单功能。

1 基础配置模块

import requests
import hmac
import hashlib
import base64
import json
import time
class OKXAPI:
    def __init__(self, api_key, secret_key, passphrase, base_url="https://www.okx.com"):
        self.api_key = api_key
        self.secret_key = secret_key
        self.passphrase = passphrase
        self.base_url = base_url
    def _generate_signature(self, timestamp, method, request_path, body=""):
        message = timestamp + method + request_path + body
        mac = hmac.new(self.secret_key.encode('utf-8'), message.encode('utf-8'), hashlib.sha256)
        return base64.b64encode(mac.digest()).decode('utf-8')
    def _send_request(self, method, endpoint, body=None):
        url = self.base_url + endpoint
        timestamp = str(int(time.time()))
        signature = self._generate_signature(timestamp, method, endpoint, body or "")
        headers = {
            "OK-ACCESS-KEY": self.api_key,
            "OK-ACCESS-SIGN": signature,
            "OK-ACCESS-TIMESTAMP": timestamp,
            "OK-ACCESS-PASSPHRASE": self.passphrase,
            "Content-Type": "application/json"
        }
        if body:
            response = requests.request(method, url, headers=headers, data=body)
        else:
            response = requests.request(method, url, headers=headers)
        return response.json()

2 获取实时行情

def get_ticker(self, inst_id):
    endpoint = f"/api/v5/market/ticker?instId={inst_id}"
    return self._send_request("GET", endpoint)
# 使用示例
api = OKXAPI(API_KEY, SECRET_KEY, PASSPHRASE)
btc_ticker = api.get_ticker("BTC-USDT")
print(f"当前BTC价格: {btc_ticker['data'][0]['last']}")

3 查询账户余额

def get_account_balance(self, ccy=None):
    endpoint = "/api/v5/account/balance"
    if ccy:
        endpoint += f"?ccy={ccy}"
    return self._send_request("GET", endpoint)

4 提交限价单

def place_limit_order(self, inst_id, side, price, size):
    endpoint = "/api/v5/trade/order"
    body = {
        "instId": inst_id,
        "tdMode": "cash",    # 现货交易
        "side": side,        # "buy" 或 "sell"
        "ordType": "limit",  # 限价单
        "px": str(price),
        "sz": str(size)
    }
    return self._send_request("POST", endpoint, json.dumps(body))

5 完整脚本运行

将上述类方法整合后,你可以通过以下代码实现自动化交易逻辑：

# 初始化API
api = OKXAPI("你的API_KEY", "你的SECRET_KEY", "你的PASSPHRASE")
# 检查账户余额
balance = api.get_account_balance("USDT")
print(f"USDT余额: {balance['data'][0]['details'][0]['availBal']}")
# 获取当前BTC价格并下单
ticker = api.get_ticker("BTC-USDT")
current_price = float(ticker['data'][0]['last'])
buy_price = round(current_price * 0.99, 2)  # 市价下浮1%
order_result = api.place_limit_order("BTC-USDT", "buy", buy_price, 0.001)
print("订单结果:", order_result)

常见问题与避坑指南

❓ 问答1：API签名失败怎么办？

答：请检查以下几点：

Secret Key是否正确复制（注意前后无空格）
系统时间是否与网络时间同步（误差超过30秒会导致签名无效）
确认使用的是GET还是POST方法，签名时的request_path需包含查询参数

❓ 问答2：如何避免API被封禁？

答：欧易API有严格的限频策略，对于REST接口，现货类请求建议不超过10次/秒，合约类不超过30次/秒，可以在代码中加入time.sleep(0.1)控制请求频率，同时推荐将API绑定IP白名单,防止外部恶意利用。

❓ 问答3：Python脚本运行报错“504 Gateway Timeout”？

答：通常是因为请求超时或服务器负载过高，可以在requests.request()中添加timeout=5参数,并实现重试机制，

for i in range(3):
    try:
        response = requests.request(method, url, headers=headers, timeout=5)
        return response.json()
    except:
        time.sleep(1)
        continue