欧易交易所官网API接口申请教程，手把手教你用Python写交易脚本

admin okx快讯 2026-06-09 1

目录导读

欧易API接口是什么？为什么你需要它？
申请欧易API接口的完整流程
Python环境搭建与必备库安装
编写第一个简单的交易脚本
脚本实战：实现自动买卖功能
常见问题与避坑指南（含问答）

欧易API接口是什么？为什么你需要它？

很多朋友刚接触加密货币交易时,都是手动在欧易交易所官网下单，盯盘累、反应慢，还容易错过最佳时机，这时候，欧易API接口就成了你的“交易外挂”——它允许你用代码直接连接交易所，实现自动下单、查询行情、设置止盈止损等操作。

欧易交易所官网API接口申请教程，手把手教你用Python写交易脚本-第1张图片-欧易交易所

简单说,API就是交易所给你的一把“数字钥匙”，让你可以用Python、Java等编程语言，代替人工操作，比如你想设置一个“BTC跌到3万自动买入”的脚本，就需要用到这个接口。

小提示：如果你还没注册欧易交易所，建议先完成欧易交易所下载并注册账号，因为API绑定必须用已实名认证的账户。

申请欧易API接口的完整流程

第1步：登录并进入API管理页面

登录你的欧易交易所官网账户（记得使用okrh.com.cn这个域名），在页面右上角找到“API”入口，通常位于用户头像下拉菜单或“账户”设置中。

第2步：创建API Key

点击“创建API Key”，系统会要求你进行安全验证（短信/邮箱/谷歌验证器），验证通过后，你需要：

给API起个名字,Python自动交易”
选择权限：至少勾选“交易”和“读取”，如果你想查询账户余额，还需勾选“资金”
设置IP白名单（强烈建议填写你的服务器IP，别留空，否则任何IP都能用你的API）

第3步：保存好你的API密钥

创建成功后,你会得到三样东西：

API Key：相当于用户名
Secret Key：相当于密码（只显示一次！ 务必保存到txt文件或密码管理器）
Passphrase：你设置的口令（也是重要凭证）

特别提醒：别在公开代码里直接写Secret Key！要用环境变量或配置文件存储。

Python环境搭建与必备库安装

1 安装Python（如果你还没有）

去Python官网下载3.8以上版本，安装时记得勾选“Add Python to PATH”。

2 安装官方SDK（推荐）

欧易提供了Python SDK，能帮你省去签名算法等麻烦，打开命令行工具，输入：

pip install okx-py

如果安装失败,可以用国内镜像源：

pip install okx-py -i https://pypi.tuna.tsinghua.edu.cn/simple

3 安装其他必要库

pip install pandas python-dotenv

python-dotenv 用来安全读取环境变量（比如你的API密钥）。

编写第一个简单的交易脚本

1 创建项目文件夹与配置文件

新建文件夹 okx_trading_bot
在里面创建 .env 文件，内容如下（别用记事本，用VS Code或Sublime Text）：

API_KEY=你的API Key
SECRET_KEY=你的Secret Key
PASSPHRASE=你的Passphrase

新建 main.py 文件

2 先写一个“查询账户余额”脚本

这个脚本能测试你的API是否连通：

import os
from dotenv import load_dotenv
from okx.Account import AccountAPI
# 加载.env文件中的密钥
load_dotenv()
# 初始化账户API
account_api = AccountAPI(
    api_key=os.getenv("API_KEY"),
    api_secret_key=os.getenv("SECRET_KEY"),
    passphrase=os.getenv("PASSPHRASE"),
    # 使用模拟盘测试（推荐新手先用模拟盘）
    flag='1'  # 0=实盘, 1=模拟盘
)
# 获取账户余额
result = account_api.get_account_balance()
if result['code'] == '0':
    print("连接成功！你的账户数据如下：")
    for coin in result['data'][0]['details']:
        print(f"{coin['ccy']}: 可用 {coin['availBal']}")
else:
    print("连接失败，请检查API密钥：", result['msg'])

运行测试：在终端执行 python main.py，如果看到币种余额，说明API打通了！

脚本实战：实现自动买卖功能

1 获取实时行情并打印

先写个函数,获取BTC/USDT的当前价格：

from okx.PublicData import PublicAPI
public_api = PublicAPI(flag='1')
ticker = public_api.get_ticker(instId='BTC-USDT')
if ticker['code'] == '0':
    print(f"BTC最新价格: {ticker['data'][0]['last']} USDT")

2 实现“跌破某个价格就买入”的自动交易

假设你想设置：当BTC价格跌到30000 USDT时，自动买入0.001个BTC。

import time
from okx.Trade import TradeAPI
trade_api = TradeAPI(
    api_key=os.getenv("API_KEY"),
    api_secret_key=os.getenv("SECRET_KEY"),
    passphrase=os.getenv("PASSPHRASE"),
    flag='1'
)
target_price = 30000  # 目标买入价
buy_amount = 0.001    # 买入数量
while True:
    # 获取最新价格
    ticker = public_api.get_ticker(instId='BTC-USDT')
    current_price = float(ticker['data'][0]['last'])
    print(f"当前BTC价格: {current_price}")
    if current_price <= target_price:
        # 下市价买单
        order = trade_api.place_order(
            instId='BTC-USDT',
            tdMode='cash',          # 现金模式
            side='buy',
            ordType='market',       # 市价单
            sz=buy_amount
        )
        if order['code'] == '0':
            print(f"买入成功！订单ID: {order['data'][0]['ordId']}")
            break
        else:
            print("买入失败:", order['msg'])
    else:
        print("价格未到目标，等待中...")
    time.sleep(60)  # 每60秒检查一次

注意：这只是一个基础Demo，真实交易还需考虑滑点、手续费、网络延迟等因素。