目录导读
欧易交易所API接口概述
欧易交易所作为全球领先的数字资产交易平台,提供了功能完善的API接口,允许开发者通过程序化方式执行交易操作,通过欧易交易所官网的API接口,用户可以获取实时行情、管理订单、查询账户余额等,本文将以Python语言为例,手把手教你完成API申请并编写简单的交易脚本。

在开始之前,建议先完成欧易交易所下载并注册账户,确保账户已完成高级认证,API接口主要分为REST API和WebSocket API两种,其中REST API适用于请求-响应模式的交易操作,而WebSocket则适合获取实时数据流。
API接口申请前的准备工作
申请欧易API接口前,需要做好以下准备:
- 已完成认证的账户:登录oe-okor.com.cn,确保账户通过身份验证。
- 绑定安全验证:建议开启Google Authenticator二次验证,增强API安全性。
- 确定API权限范围:根据用途选择只读(查询余额、行情)或交易权限(下单、撤单)。
重要提示:API密钥(API Key和Secret Key)一旦生成,请务必妥善保管,切勿分享给他人,也不要存储在公开代码仓库中。
欧易API接口申请完整流程
步骤1:登录欧易账户
访问欧易交易所官网,完成登录。
步骤2:进入API管理页面
在账户设置中找到“API”选项,点击“创建API”。
步骤3:填写API信息
- API名称:建议填写有辨识度的名称,如”Python交易脚本”
- 权限设置:如仅做数据查询,勾选“读取”;如需交易,勾选“交易”
- IP白名单:建议绑定服务器或本机公网IP,防止密钥被盗用
步骤4:完成安全验证
输入资金密码和Google验证码,确认创建。
步骤5:保存密钥
成功创建后,系统会显示API Key和Secret Key,请立即复制并保存到安全位置,关闭页面后将无法再次查看Secret Key。
Python环境搭建与依赖安装
确保已安装Python 3.7以上版本,然后安装必要的第三方库:
pip install requests pip install hashlib pip install hmac pip install base64
其中requests用于发送HTTP请求,hashlib和hmac用于生成签名验证。
编写第一个交易脚本:获取账户信息
以下脚本演示如何通过API获取账户余额,这是所有交易脚本的基础。
import requests
import hmac
import hashlib
import base64
import json
import time
# 请替换为你的API密钥
API_KEY = "你的API_KEY"
SECRET_KEY = "你的SECRET_KEY"
PASSPHRASE = "你的PASSPHRASE"
# 基础URL
base_url = "https://www.oe-okor.com.cn"
# 生成签名
def generate_sign(timestamp, method, request_path, body):
message = str(timestamp) + method + request_path + (body or "")
mac = hmac.new(bytes(SECRET_KEY, encoding='utf8'),
bytes(message, encoding='utf-8'),
digestmod=hashlib.sha256)
return base64.b64encode(mac.digest()).decode('utf-8')
# 获取账户信息
def get_account_info():
request_path = "/api/v5/account/balance"
method = "GET"
body = ""
timestamp = str(int(time.time()))
headers = {
"OK-ACCESS-KEY": API_KEY,
"OK-ACCESS-SIGN": generate_sign(timestamp, method, request_path, body),
"OK-ACCESS-TIMESTAMP": timestamp,
"OK-ACCESS-PASSPHRASE": PASSPHRASE,
"Content-Type": "application/json"
}
response = requests.get(base_url + request_path, headers=headers)
return response.json()
# 执行
if __name__ == "__main__":
result = get_account_info()
print(json.dumps(result, indent=2))
将代码中的API_KEY、SECRET_KEY、PASSPHRASE替换为你在欧易交易所下载后申请的密钥,运行即可查看账户余额。
进阶:实现自动下单功能
掌握基础API调用后,可以编写自动下单脚本,以下是一个限价单下单示例:
def place_order(inst_id, side, sz, px):
request_path = "/api/v5/trade/order"
method = "POST"
body = {
"instId": inst_id, # 交易对,如BTC-USDT
"tdMode": "cash", # 现货交易
"side": side, # buy或sell
"ordType": "limit", # 限价单
"sz": str(sz), # 数量
"px": str(px) # 价格
}
body_str = json.dumps(body)
timestamp = str(int(time.time()))
headers = {
"OK-ACCESS-KEY": API_KEY,
"OK-ACCESS-SIGN": generate_sign(timestamp, method, request_path, body_str),
"OK-ACCESS-TIMESTAMP": timestamp,
"OK-ACCESS-PASSPHRASE": PASSPHRASE,
"Content-Type": "application/json"
}
response = requests.post(base_url + request_path, data=body_str, headers=headers)
return response.json()
# 示例:以50000 USDT价格买入0.01 BTC
result = place_order("BTC-USDT", "buy", 0.01, 50000)
print(result)
风险提示:请先在模拟盘测试,确认无误后再使用实盘,具体的API参数详情,可参考欧易交易所官网的开发者文档。
常见问题解答(FAQ)
Q1:API密钥泄露了怎么办?
立即登录账户,在API管理页面删除泄露的密钥,并生成新的密钥,同时检查账户是否有异常交易记录,建议重置资金密码。
Q2:为什么签名总是验证失败?
常见原因包括:系统时间与服务器时间不同步(偏差超过30秒)、Secret Key复制错误、请求路径或参数与文档不一致,请使用ntp同步时间,并核对密钥信息。
Q3:如何提高API请求频率?
欧易对API有频率限制,基础限制为每秒10次,如需更高频率,可联系客服申请,建议在代码中加入重试机制和请求队列。
Q4:Python脚本可以跑在云服务器上吗?
可以,建议在云服务器上运行,确保IP已加入白名单,定期检查脚本运行状态,并做好异常处理。
Q5:哪里可以获取更详细的API文档?
直接访问oe-okor.com.cn的“开发者文档”专区,那里提供了所有REST和WebSocket接口的详细说明、参数定义和示例代码,完成欧易交易所下载后,在用户中心也能找到技术文档入口。
通过本文的教程,你已经掌握了从API申请到Python脚本编写的完整流程,建议先从获取行情数据开始练习,熟练后再尝试自动交易,数字资产交易存在风险,请务必使用模拟盘充分测试,理性投资。
标签: 欧易API Python交易脚本