目录导读
- 欧易交易所API是什么？为什么交易员都在用？
- 欧易API接口申请全流程（附避坑指南）
- Python环境搭建与必备库安装
- 手把手教你编写第一个自动化交易脚本
- 常见问题问答（FAQ）
- 风险提示与合规建议
欧易交易所API是什么？为什么交易员都在用？
如果你是加密货币交易者,一定听说过“量化交易”“网格策略”这些词，而欧易交易所官网提供的API接口，正是实现这些自动化策略的核心工具。
简单说,API就是交易所给你开的一扇“后门”，你可以通过代码直接下指令：查行情、看余额、自动买卖，甚至写一个程序24小时帮你盯盘，相比手动操作，API交易速度快、无情绪干扰，还能同时管理多个账户。
补充说明： 对于想深度体验自动交易的朋友，建议先完成欧易交易所下载并注册账户，再进行API申请，确保账户安全。
欧易API接口申请全流程（附避坑指南）
步骤1：登录欧易账户
打开欧易交易所官网（建议使用域名：https://okzn.com.cn/），登录你的交易账户，注意：不要用子账户申请API，某些权限绑定主账户才完整。
步骤2：进入API管理页面
在账户菜单中找到“API”选项，点击“创建API Key”，系统会要求进行二次验证（短信或谷歌验证器），这一步千万别跳过，这是资产安全的第一道防线。
步骤3：设置权限
这是新手最容易踩坑的地方！
- 交易权限：勾选后可以通过API下单、撤单
- 读取权限：查看账户余额和订单状态
- 提币权限：强烈建议不要勾选！除非你明确知道自己在做什么
我的建议是：初期只开启“交易+读取”，等熟悉后再考虑扩展。
步骤4：保存Key和Secret
创建完成后,你会得到：
- API Key（一串字符，类似用户名）
- Secret Key（类似密码，仅显示一次）
重要： 把Secret Key复制到记事本或密码管理器里，一旦关闭页面，你就再也看不到了，只能重新生成，别问我怎么知道的……
步骤5：绑定IP白名单（可选但推荐）
欧易允许你限定哪些IP可以调用API,如果你用的是固定IP（比如云服务器），填写上去；如果是家用动态IP，可以先留空，设置后更安全，但记得别把自己锁在外面。
Python环境搭建与必备库安装
假设你已经安装了Python 3.7+（建议用3.9或3.10），接下来安装两个关键库：
pip install requests pip install python-dotenv
requests用来发送HTTP请求，dotenv用来管理API Key这类敏感信息（避免写死在代码里）。
补充说明： 关于API的技术细节，可以参考欧易交易所官网的开发者文档，那里有最权威的接口说明和示例代码。
手把手教你编写第一个自动化交易脚本
场景设定
写一个简单的脚本：查询BTC/USDT的最新价格，如果价格低于某个阈值（比如30000 USDT），就自动买入0.01个BTC，这只是演示，不建议直接用实盘测试！
完整代码
import requests
import json
import time
import hmac
import hashlib
import base64
from urllib.parse import urlencode
# 从环境变量读取你的API密钥（更安全）
from dotenv import load_dotenv
import os
load_dotenv()
API_KEY = os.getenv('OKX_API_KEY')
SECRET_KEY = os.getenv('OKX_SECRET_KEY')
PASSPHRASE = os.getenv('OKX_PASSPHRASE') # 创建API时设置的交易密码
BASE_URL = 'https://www.okx.com' # 欧易API基地址
def get_signature(timestamp, method, request_path, body=''):
"""生成签名（欧易要求的HMAC SHA256）"""
message = timestamp + method + request_path + body
mac = hmac.new(bytes(SECRET_KEY, encoding='utf8'), bytes(message, encoding='utf-8'), digestmod=hashlib.sha256)
d = mac.digest()
return base64.b64encode(d).decode()
def get_ticker(symbol='BTC-USDT'):
"""获取最新行情"""
path = '/api/v5/market/ticker?instId=' + symbol
response = requests.get(BASE_URL + path)
data = response.json()
return float(data['data'][0]['last']) # 最新成交价
def place_order(symbol, side, size):
"""下单（市价单示例）"""
timestamp = str(int(time.time()))
body = {
'instId': symbol,
'tdMode': 'cash', # 现货交易
'side': side, # 'buy'或'sell'
'ordType': 'market', # 市价单
'sz': str(size) # 数量
}
body_json = json.dumps(body)
# 生成签名
signature = get_signature(timestamp, 'POST', '/api/v5/trade/order', body_json)
headers = {
'OK-ACCESS-KEY': API_KEY,
'OK-ACCESS-SIGN': signature,
'OK-ACCESS-TIMESTAMP': timestamp,
'OK-ACCESS-PASSPHRASE': PASSPHRASE,
'Content-Type': 'application/json'
}
response = requests.post(BASE_URL + '/api/v5/trade/order', headers=headers, data=body_json)
return response.json()
# ---- 主逻辑 ----
if __name__ == '__main__':
target_price = 30000 # 你设定的买入阈值
current_price = get_ticker()
print(f'当前BTC价格: {current_price} USDT')
if current_price < target_price:
print('价格低于阈值，执行买入...')
result = place_order('BTC-USDT', 'buy', 0.01)
print('下单结果:', result)
else:
print('价格未达标，继续观望')
代码说明
- 签名生成：欧易API要求每个请求都带时间戳和HMAC签名，防止篡改，这个函数帮你自动搞定。
- 行情查询：
get_ticker函数调用了欧易的公开行情接口，不需要密钥也能用。 - 下单函数：
place_order演示了如何用市价单买入，注意传入了交易密码（Passphrase）。 - 环境变量：强烈建议用
.env文件管理密钥，示例：
OKX_API_KEY=你的APIKey
OKX_SECRET_KEY=你的SecretKey
OKX_PASSPHRASE=你的交易密码运行脚本
在终端执行：python my_trader.py
第一次建议用模拟盘或小额测试，确认无误再放大金额，建议定期访问欧易交易所官网查看API版本更新，确保兼容性。
常见问题问答（FAQ）
Q1：API Key泄露了怎么办？
A：立刻登录欧易交易所官网，进入API管理页面，删除该API Key并重新生成，同时检查账户是否有异常交易记录。
Q2：代码提示“签名错误”是什么原因？
A：最常见的原因是服务器时间与你的本地时间不同步，建议代码中通过欧易的时间接口获取时间戳，而不是用本地时间。
Q3：可以同时用多个API Key交易吗？
A：可以，欧易没有限制API数量，但建议每个Key只用于一个策略，方便追溯问题。
Q4：市价单和限价单有什么区别？
A：市价单立即按当前最优价成交，适合快速入场；限价单按你指定的价格挂单，可能不会立即成交，初学建议从市价单开始。
Q5：运行脚本时遇到“请求频率过高”怎么办？
A：欧易对API调用有频率限制，普通用户每秒最多20次，在代码中添加time.sleep(0.1)适当延时即可。
风险提示与合规建议
自动化交易虽然方便,但有几个坑要特别注意：
- 先模拟再实盘：欧易有模拟盘环境（Demo），建议先用模拟盘测试策略。
- 设置止损：永远不要相信“只会涨不会跌”，代码里加上价格监控，一旦亏损达到阈值，自动清仓。
- 定期检查：即使自动化了，也要每周登录账户看一眼，防止代码出现bug导致无限下单。
- API权限最小化：除非必要，不要给API提币权限，很多被盗案例都是因为API权限设置过大。
最后提醒一句：任何交易都有风险，API自动化也不例外，用闲钱投资，做好风控，才是长期生存之道，如果你对量化交易感兴趣，不妨从欧易交易所下载一个模拟账户，用我们今天写的脚本先跑几天数据看看效果。
标签： Python交易脚本
