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

admin ok快讯 2026-07-30 2

目录导读

欧易API接口申请前提条件
欧易交易所API密钥生成与权限设置
Python环境搭建与依赖库安装
基于欧易API的简单交易脚本编写
常见问题与避坑指南
问答环节：欧易交易脚本高频疑问解答

欧易API接口申请前提条件

在正式开始编写交易脚本之前,您需要确认自己已完成以下准备：

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

注册并登录欧易交易所账户，并完成基础身份认证（KYC一级即可）。
确保账户内有足够的USDT或其他交易对的基础资产,用于测试或实盘操作。
电脑已安装Python 3.7及以上版本，并熟悉基础语法。

小贴士：如果你是第一次使用欧易交易所下载功能，建议先在模拟盘或小额资金下测试脚本稳定性。

欧易交易所API密钥生成与权限设置

1 进入API管理页面

登录您的欧易交易所账户，点击右上角头像 → “API” → “创建API”，此时系统会要求进行二次验证（邮箱或手机验证码）。

2 创建API并设置权限

输入API名称（便于区分用途，mytradingbot”）。
权限选择：必须勾选“交易”权限（若仅查询行情，可选“读取”）；建议不勾选“提现”权限，防止意外风险。
设置IP白名单（可选但推荐）：填写您的服务器或本地电脑公网IP，提升安全性。

生成后,您会得到两串关键信息：API Key 和 Secret Key，请将Secret Key保存在安全的地方，关闭页面后无法再次查看。

3 理解API签名机制

欧易API采用HMAC-SHA256签名，所有请求（除公开行情外）都需携带签名参数，您的Python脚本需要自动生成签名，否则请求会被拒绝。

Python环境搭建与依赖库安装

1 安装必要库

打开终端或命令提示符,执行以下命令：

pip install requests hashlib hmac base64 time json

注意：requests用于HTTP请求，hashlib和hmac用于签名计算。

2 导入库并定义基础变量

import requests
import hmac
import hashlib
import base64
import time
import json
API_KEY = "您的API Key"
SECRET_KEY = "您的Secret Key"
BASE_URL = "https://www.ox-okbb.com.cn"   # 请替换为实际的欧易API域名
PASSPHRASE = "您在创建API时设置的 passphrase"

基于欧易API的简单交易脚本编写

1 获取实时行情（公开接口）

def get_ticker(symbol):
    url = f"{BASE_URL}/api/v5/market/ticker?instId={symbol}"
    response = requests.get(url)
    return response.json()

调用示例：print(get_ticker("BTC-USDT")) 可返回比特币当前价格。

2 生成签名函数（核心）

def generate_sign(timestamp, method, request_path, body):
    message = timestamp + method + request_path + (body or "")
    mac = hmac.new(bytes(SECRET_KEY, encoding='utf8'), bytes(message, encoding='utf-8'), digestmod=hashlib.sha256)
    digest = mac.digest()
    return base64.b64encode(digest).decode()

3 设置请求头

def get_header(method, request_path, body):
    timestamp = str(time.time())
    sign = generate_sign(timestamp, method, request_path, body)
    return {
        "OK-ACCESS-KEY": API_KEY,
        "OK-ACCESS-SIGN": sign,
        "OK-ACCESS-TIMESTAMP": timestamp,
        "OK-ACCESS-PASSPHRASE": PASSPHRASE,
        "Content-Type": "application/json"
    }

4 下单交易（限价买入）

def place_order(symbol, side, size, price):
    body = {
        "instId": symbol,
        "tdMode": "cash",  # 现货交易
        "side": side,      # "buy" 或 "sell"
        "ordType": "limit",
        "sz": size,        # 数量
        "px": price        # 价格
    }
    body_json = json.dumps(body)
    request_path = "/api/v5/trade/order"
    header = get_header("POST", request_path, body_json)
    url = f"{BASE_URL}{request_path}"
    response = requests.post(url, headers=header, data=body_json)
    return response.json()

调用示例：print(place_order("ETH-USDT", "buy", 0.01, 1800)) 表示以1800 USDT的价格买入0.01个ETH。

5 查看账户余额

def get_account():
    request_path = "/api/v5/account/balance"
    header = get_header("GET", request_path, None)
    url = f"{BASE_URL}{request_path}"
    response = requests.get(url, headers=header)
    return response.json()