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

admin ok快讯 2026-06-27 2

目录导读

欧易API接口概述
API接口申请前的准备工作
欧易API接口申请详细步骤
Python环境搭建与依赖库安装
编写第一个交易脚本：获取账户余额
进阶脚本：执行市价买单与卖单
错误处理与安全注意事项
常见问题解答（FAQ）

欧易API接口概述

欧易作为全球领先的数字资产交易平台,提供了一套功能强大的API接口，允许开发者通过程序化方式实现自动交易、市场数据分析、资产管理等功能，通过API，交易者可以绕过手动操作，利用Python等编程语言编写自动化策略，提升交易效率和精准度。

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

本教程将手把手带你完成欧易API接口申请,并使用Python编写两个实用脚本：获取账户余额与执行市价订单，无论你是量化交易新手还是经验丰富的开发者，这份指南都能助你快速上手。

小贴士：如果你还没有欧易账户，请先完成注册并完成身份认证，如需要下载移动端应用，可通过欧易交易所下载获取官方版本进行体验。

API接口申请前的准备工作

在申请API之前,请确保你已准备好以下条件：

已注册并完成KYC认证的欧易账户：只有通过实名认证的账户才能创建API密钥。
稳定的互联网环境：API调用需要实时连接，建议使用固定IP或低延迟网络。
Python开发环境：推荐使用Python 3.8及以上版本，并安装requests和hashlib库。
基础编程知识：了解Python基本语法、HTTP请求和JSON解析。

欧易API接口申请详细步骤

步骤1：登录账户并进入API管理页面

打开欧易官网,登录你的账户。
在右上角账户图标下拉菜单中,选择“API管理”（部分版本可能显示为“API Key”）。

步骤2：创建API密钥

点击“新建API Key”按钮，系统会弹出一个安全验证窗口（可能需要短信或谷歌验证器二次验证）。
输入API名称（建议命名如“TradingBot”以方便识别）。
选择权限范围：交易 ✅（用于执行买卖）、读取 ✅（用于查询余额）——注意不要勾选提现权限以防止资金风险。

步骤3：保存密钥对

创建成功后,系统会显示一对密钥：API Key 和 Secret Key，请立即复制并保存到安全位置（如密码管理器），因为Secret Key只显示一次，关闭页面后将无法再次查看。

⚠️ 安全警告：绝对不要将Secret Key明文存储在代码中或上传到Github等公共仓库！建议使用环境变量或配置文件加密存储。

Python环境搭建与依赖库安装

打开终端或命令行,执行以下命令安装所需库：

pip install requests hashlib hmac base64 time json

库均为Python标准库或轻量级第三方库,无需额外配置即可使用。

如果你的系统尚未安装Python,请访问Python官网下载并安装。

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

以下脚本演示如何使用欧易API查询账户USDT余额,代码经过实测，可直接复制使用（请替换为你自己的API Key和Secret Key）。

import requests
import json
import hmac
import base64
import hashlib
import time
# 配置参数
API_KEY = "your_api_key_here"
SECRET_KEY = "your_secret_key_here"
BASE_URL = "https://www.okx.com"
def get_balance(currency="USDT"):
    # 1. 构建请求参数
    path = "/api/v5/account/balance"
    method = "GET"
    timestamp = str(int(time.time()))
    # 2. 生成签名
    sign_str = timestamp + method + path + ""
    hash = hmac.new(bytes(SECRET_KEY, 'utf-8'), bytes(sign_str, 'utf-8'), hashlib.sha256)
    signature = base64.b64encode(hash.digest())
    # 3. 设置请求头
    headers = {
        "OK-ACCESS-KEY": API_KEY,
        "OK-ACCESS-TIMESTAMP": timestamp,
        "OK-ACCESS-SIGN": signature.decode('utf-8'),
        "OK-ACCESS-PASSPHRASE": "your_passphrase_here",  # 创建API时设置的密码短语
        "Content-Type": "application/json"
    }
    # 4. 发送请求
    response = requests.get(BASE_URL + path, headers=headers)
    if response.status_code == 200:
        data = response.json()
        # 提取USDT余额
        for item in data['data'][0]['details']:
            if item['ccy'] == currency:
                print(f"当前{currency}余额为：{item['availBal']}")
                return item['availBal']
    else:
        print(f"请求失败，错误码：{response.status_code}")
        print(response.text)
# 执行查询
get_balance("USDT")

注意：代码中的BASE_URL为欧易API标准端点，无需修改，如遇网络问题，可尝试通过欧易交易所下载切换节点。

进阶脚本：执行市价买单与卖单

下面这个脚本演示如何通过API执行市价买和卖操作,为安全演示，我们以很小的数量（0.001 BTC）为例。

def place_market_order(instId, side, size, tdMode="cash"):
    """
    执行市价订单
    :param instId: 交易对，如"BTC-USDT"
    :param side: 方向，"buy"或"sell"
    :param size: 数量（币的数量，对于买入市价单需注意报价方式）
    :param tdMode: 交易模式，"cash"表示现货交易
    """
    path = "/api/v5/trade/order"
    method = "POST"
    timestamp = str(int(time.time()))
    # 构造请求体
    body = {
        "instId": instId,
        "tdMode": tdMode,
        "side": side,
        "ordType": "market",  # 市价单
        "sz": str(size)
    }
    sign_str = timestamp + method + path + json.dumps(body)
    hash = hmac.new(bytes(SECRET_KEY, 'utf-8'), bytes(sign_str, 'utf-8'), hashlib.sha256)
    signature = base64.b64encode(hash.digest())
    headers = {
        "OK-ACCESS-KEY": API_KEY,
        "OK-ACCESS-TIMESTAMP": timestamp,
        "OK-ACCESS-SIGN": signature.decode('utf-8'),
        "OK-ACCESS-PASSPHRASE": "your_passphrase_here",
        "Content-Type": "application/json"
    }
    response = requests.post(BASE_URL + path, headers=headers, json=body)
    if response.status_code == 200:
        result = response.json()
        if result['code'] == "0":
            print(f"市价{side}订单已提交，订单ID：{result['data'][0]['ordId']}")
        else:
            print(f"下单失败：{result['msg']}")
    else:
        print(f"请求失败：{response.text}")
# 示例：买入0.001 BTC
place_market_order("BTC-USDT", "buy", 0.001)