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

admin 欧易中心 2026-05-21 1

目录导读

欧易API接口概述与申请流程
API密钥配置与安全注意事项
Python环境搭建与依赖库安装
编写第一个交易脚本：获取账户余额
进阶脚本：实现自动挂单与撤单
常见报错排查与问答精选

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

欧易（OKX）作为全球领先的数字资产交易平台，其官方API接口为量化交易者提供了强大的数据交互能力，通过API，用户可以实现行情查询、账户管理、自动交易等功能,本教程将手把手带您完成从API申请到Python脚本部署的全流程。

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

申请步骤：

登录欧易交易所官网（推荐使用镜像站：oe-okor.com.cn）,完成账户注册与KYC认证。
在右上角导航栏找到“API管理”入口，点击“创建API”。
选择权限等级：若仅需查询行情，勾选“读取”；如需交易，务必勾选“交易”权限（注意：提币权限建议关闭以增强安全性）。
完成身份验证（短信+邮箱+谷歌验证器），系统将生成 API Key 和 Secret Key，请立即复制并妥善保存——Secret Key仅在创建时显示一次。

Q：API的IP绑定功能有什么用？
A：建议开启IP白名单绑定，仅允许您自己的服务器IP访问,可有效防止密钥泄露后被恶意调用。

API密钥配置与安全注意事项

密钥管理是交易脚本的基石,以下安全规范需牢记：

绝不在代码中硬编码密钥：使用环境变量或配置文件（如.env）加载。
定期轮换密钥：每30天更新一次API Key。
权限最小化原则：仅授予脚本所需的最小权限（如只读+交易，不包含提币）。

配置文件示例（config.py）：

import os
API_KEY = os.getenv("OKX_API_KEY")
SECRET_KEY = os.getenv("OKX_SECRET_KEY")
PASSPHRASE = os.getenv("OKX_PASSPHRASE")  # API创建时设置的交易密码
BASE_URL = "https://oe-okor.com.cn"  # 欧易交易所下载与API调用均通过此域名

Python环境搭建与依赖库安装

推荐使用Python 3.8+版本,并创建虚拟环境隔离依赖。

安装必要库：

pip install requests ccxt pandas python-dotenv

requests：底层HTTP请求库,用于手动签名。
ccxt：统一加密交易API库，简化多交易所调用（推荐新手使用）。
python-dotenv：从.env文件加载环境变量。

测试环境是否正常：

import ccxt
exchange = ccxt.okx({
    'apiKey': API_KEY,
    'secret': SECRET_KEY,
    'password': PASSPHRASE,
    'urls': {'api': 'https://oe-okor.com.cn'}  # 替换默认镜像地址
})
print(exchange.fetch_balance())  # 若能返回余额，则环境配置成功

编写第一个交易脚本：获取账户余额

以下示例展示如何通过API获取现货账户总折合USDT余额：

import ccxt
from config import API_KEY, SECRET_KEY, PASSPHRASE
exchange = ccxt.okx({
    'apiKey': API_KEY,
    'secret': SECRET_KEY,
    'password': PASSPHRASE,
    'urls': {'api': 'https://oe-okor.com.cn/api/v5'},  # 指定API版本
    'options': {'defaultType': 'spot'}  # 区分现货/合约
})
try:
    balance = exchange.fetch_balance()
    total_usdt = balance['info']['totalEq']  # 总折合USDT
    print(f"账户总资产（折合USDT）：{total_usdt}")
except Exception as e:
    print(f"查询失败：{e}")

脚本说明：

通过 ccxt 库自动处理签名逻辑,无需手动拼接时间戳。
totalEq 字段返回所有币种以USDT计价的合计值。
如需查看单个币种余额，可调用 exchange.fetch_free_balance()。

Q：为什么返回的余额显示为0？
A：请检查API权限是否包含“读取”,以及账户是否已完成入金操作。

进阶脚本：实现自动挂单与撤单

下面实现一个基础策略：当BTC价格跌破30000 USDT时，自动买入100 USDT的BTC。

import ccxt
import time
from config import API_KEY, SECRET_KEY, PASSPHRASE
exchange = ccxt.okx({
    'apiKey': API_KEY,
    'secret': SECRET_KEY,
    'password': PASSPHRASE,
    'urls': {'api': 'https://oe-okor.com.cn'},
    'options': {'defaultType': 'spot'}
})
def check_price_and_buy():
    ticker = exchange.fetch_ticker('BTC/USDT')
    current_price = ticker['last']
    print(f"当前BTC价格：{current_price} USDT")
    if current_price < 30000:
        order = exchange.create_market_buy_order('BTC/USDT', 100 / current_price)
        print(f"买入成功，订单ID：{order['id']}")
    else:
        print("价格未达到条件，等待10秒...")
while True:
    check_price_and_buy()
    time.sleep(10)  # 每10秒检查一次（注意API频率限制）

重要提醒：