目录导读
欧易API基础介绍
欧易交易所作为全球领先的数字资产交易平台，其API接口为开发者提供了自动化交易、市场数据获取、账户管理等功能，通过API，用户可以编写程序实现24小时不间断交易，避免情绪化操作，欧易API采用RESTful架构，支持HTTP/HTTPS协议，返回JSON格式数据，兼容Python、Java、Go等多种主流编程语言。
使用API前需要理解几个核心概念：
- API Key：用于身份验证的公钥
- Secret Key：用于签名请求的私钥
- Passphrase：创建API时设置的安全短语
- 时间戳：所有请求必须包含精确到毫秒的时间戳
特别提示：申请API时建议仅赋予“交易”和“读取”权限，切勿开启“提现”权限以保障资产安全,更多交易功能可参考欧易交易所下载页面的官方文档。
欧易API申请完整流程
步骤1：登录账号并进入API管理
登录欧易交易所官网后，点击右上角头像，选择“API”选项，如果你是首次使用，系统会要求完成身份验证（KYC二级认证）。
步骤2：创建API密钥
- 点击“创建API”按钮
- 输入备注名称（如“Python交易脚本”）
- 选择权限（建议勾选“读取”和“交易”，关闭“提现”）
- 设置IP白名单（可选，但推荐填写服务器公网IP以增强安全性）
- 设置Passphrase（至少8位，包含字母和数字）
- 点击确认，系统会生成API Key和Secret Key
重要提醒：Secret Key仅显示一次，请立即保存到安全位置,如遗失需重新创建。
步骤3：验证API连通性
创建完成后，建议使用Postman或curl命令测试连通性，以下为curl测试命令示例：
curl -X GET "https://www.okx.com/api/v5/account/balance" \ -H "OK-ACCESS-KEY: your-api-key" \ -H "OK-ACCESS-SIGN: generated-signature" \ -H "OK-ACCESS-PASSPHRASE: your-passphrase" \ -H "OK-ACCESS-TIMESTAMP: 2023-01-01T00:00:00.000Z"
成功返回账户余额数据即表示配置正确。
Python环境准备与依赖安装
环境要求
- Python 3.7及以上版本
- pip包管理工具
- 稳定的网络连接（建议使用海外服务器避免延迟）
安装必要依赖
pip install requests hashlib hmac base64 json time
其中requests用于HTTP请求，hashlib和hmac用于签名生成，json处理数据格式，time生成时间戳。
源码结构建议
okx_trading/
├── config.py # 存储API密钥配置
├── utils.py # 签名生成工具函数
├── market_data.py # 市场数据获取模块
├── trading.py # 交易执行模块
└── main.py # 主程序入口编写第一个交易脚本
配置文件（config.py）
API_KEY = "your-api-key-here" SECRET_KEY = "your-secret-key-here" PASSPHRASE = "your-passphrase" BASE_URL = "https://www.okx.com"
安全警告：切勿将配置文件上传至公开代码仓库！建议使用环境变量替代硬编码。
签名工具函数（utils.py）
import hmac
import hashlib
import base64
import time
import requests
def generate_signature(timestamp, method, request_path, body=""):
message = timestamp + method.upper() + request_path + (body if body else "")
mac = hmac.new(
bytes(SECRET_KEY, encoding='utf8'),
bytes(message, encoding='utf-8'),
digestmod='sha256'
)
return base64.b64encode(mac.digest()).decode('utf-8')
def get_headers(method, request_path, body=""):
timestamp = str(int(time.time() * 1000))
signature = generate_signature(timestamp, method, request_path, body)
return {
"OK-ACCESS-KEY": API_KEY,
"OK-ACCESS-SIGN": signature,
"OK-ACCESS-TIMESTAMP": timestamp,
"OK-ACCESS-PASSPHRASE": PASSPHRASE,
"Content-Type": "application/json"
}
获取实时行情（market_data.py）
def get_ticker(symbol="BTC-USDT"):
request_path = f"/api/v5/market/ticker?instId={symbol}"
url = BASE_URL + request_path
headers = get_headers("GET", request_path)
response = requests.get(url, headers=headers)
return response.json()
if __name__ == "__main__":
data = get_ticker()
print(f"当前BTC价格：{data['data'][0]['last']} USDT")
执行市价买入（trading.py）
def place_market_order(symbol, side, size):
body = {
"instId": symbol,
"tdMode": "cash",
"side": side,
"ordType": "market",
"sz": str(size)
}
request_path = "/api/v5/trade/order"
url = BASE_URL + request_path
headers = get_headers("POST", request_path, json.dumps(body))
response = requests.post(url, headers=headers, json=body)
return response.json()
# 示例：以市价买入0.01个BTC
result = place_market_order("BTC-USDT", "buy", 0.01)
print(result)
完整运行脚本（main.py）
import time
from market_data import get_ticker
from trading import place_market_order
def simple_trading_bot():
symbol = "ETH-USDT"
while True:
try:
ticker = get_ticker(symbol)
price = float(ticker['data'][0]['last'])
print(f"{symbol} 当前价格：{price}")
if price < 2000: # 简单阈值策略
order = place_market_order(symbol, "buy", 0.1)
print("买入订单已提交：", order)
break
time.sleep(60)
except Exception as e:
print("发生错误：", e)
time.sleep(10)
if __name__ == "__main__":
simple_trading_bot()
重要提醒：运行前请先在测试网（模拟盘）验证脚本功能，欧易提供了Sandbox环境，URL为https://www.okx.com，但需使用测试专用的API Key。
常见问题与最佳实践
高频交易优化
- 使用WebSocket API替代REST API获取实时数据
- 本地维护订单簿缓存
- 采用异步IO框架（如asyncio）
风险管理策略
- 设置最大持仓限制
- 单笔交易金额不超过总资产的2%
- 添加熔断机制（如连续亏损3次暂停交易）
错误码排查
| 错误码 | 含义 | 解决方案 |
|---|---|---|
| 400 | 请求参数错误 | 检查字段名称和格式 |
| 401 | 认证失败 | 重新生成签名 |
| 429 | 请求频率超限 | 增加间隔时间（建议>200ms） |
问答环节
Q1：申请API时提示“安全验证失败”怎么办？
A：请确认Passphrase是否包含特殊字符，以及Secret Key是否完整复制，建议在欧易交易所官网重新创建API,并手动输入Passphrase。
Q2：脚本运行时出现“signature mismatch”错误？
A：常见原因包括：1）时间戳与服务器时间偏差超过30秒（解决：同步NTP时间）；2）请求路径未包含查询参数（GET请求必须拼接完整路径）；3）Secret Key包含非法字符。
Q3：如何用Python获取历史K线数据？
A：调用/api/v5/market/candles接口，参数包括instId（交易对）、bar（时间粒度，如1m/5m/1H）、limit（返回条数，最大300），示例请求：
request_path = "/api/v5/market/candles?instId=BTC-USDT&bar=1H&limit=100"
Q4：欧易支持哪些交易对？
A：通过/api/v5/public/instruments接口可获取所有交易对，参数instType可选SPOT（币币）、SWAP（永续）、FUTURES（交割）。
Q5：脚本部署在服务器上需要注意什么？
A：推荐使用Linux系统（Ubuntu 20.04+），配置systemd服务实现开机自启，并使用虚拟环境隔离依赖,同时应通过[欧易交易所下载]的官方渠道获取最新API文档。
延伸阅读：建议开发者关注欧易官方开发者论坛和GitHub仓库，参与开源交易策略项目，对于量化交易初学者，可以先在模拟盘测试Simple Moving Average、RSI等经典策略,逐步过渡到机器学习模型。
