目录导读
- 欧易API接口概述
- API申请前的准备工作
- 欧易API接口申请详细步骤
- Python环境配置与依赖安装
- 编写第一个交易脚本：获取账户余额
- 进阶功能：市价单与限价单交易
- 常见问题与错误排查
- 问答环节：解答高频疑问
欧易API接口概述
欧易交易所（OKX）作为全球领先的数字资产交易平台，其API接口为开发者提供了自动化交易、数据查询、账户管理等核心功能，通过API，用户可以利用Python等编程语言实现24小时不间断的量化交易策略，极大提升交易效率，本教程将带您从零开始，完成欧易API接口申请,并编写首个Python交易脚本。
重要提示：使用API交易前，请确保您在欧易交易所下载并完成账户注册与身份认证。
API申请前的准备工作
在申请API之前,您需要完成以下步骤：
- 账户注册：访问欧易官网完成注册。
- 身份认证：通过KYC二级认证,否则API权限受限。
- 双重验证（2FA）：开启谷歌验证或短信验证,这是安全使用API的必要条件。
欧易API接口申请详细步骤
- 登录欧易交易所下载账户，进入“账户中心”。
- 在左侧菜单找到“API”选项，点击“创建API”。
- 选择API类型：通常选择“交易API”即可，如需读取数据也可选择“只读API”。
- 设置权限：勾选“交易”、“提币”、“读取”等权限（建议按需开放，减少风险）。
- 绑定IP地址（可选）：如果您在固定IP环境下操作,绑定IP可增强安全性。
- 完成双重验证后，系统将生成 API Key 和 Secret Key。
⚠️ 请务必妥善保管Secret Key,一旦泄露请立即删除并重新生成。
Python环境配置与依赖安装
确保已安装Python 3.7及以上版本,然后安装必需的库：
pip install requests pip install ccxt # 可选，用于简化交易所API调用
ccxt 是一个支持多家交易所的统一接口库，但本教程将直接使用原生requests库,以便您更深入理解API调用原理。
编写第一个交易脚本：获取账户余额
以下Python脚本将演示如何通过欧易API获取账户余额：
import requests
import time
import hmac
import hashlib
import base64
# 请替换为您的真实API信息
api_key = "YOUR_API_KEY"
secret_key = "YOUR_SECRET_KEY"
passphrase = "YOUR_PASSPHRASE" # 创建API时设置的密码
# 请求基础URL
base_url = "https://www.okx.com"
# 生成签名
def get_sign(timestamp, method, request_path, body):
message = timestamp + method + request_path + (body if body else "")
mac = hmac.new(bytes(secret_key, encoding='utf-8'), bytes(message, encoding='utf-8'), digestmod=hashlib.sha256)
return base64.b64encode(mac.digest()).decode()
# 获取账户余额
def get_account_balance():
method = "GET"
request_path = "/api/v5/account/balance"
timestamp = str(time.time())
sign = get_sign(timestamp, method, request_path, "")
headers = {
"OK-ACCESS-KEY": api_key,
"OK-ACCESS-SIGN": sign,
"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_balance()
print(result)
运行结果说明：脚本将返回JSON格式的账户余额数据，包括各币种的总量、可用余额及冻结数量。
进阶功能：市价单与限价单交易
1 提交市价买单
def place_market_order(symbol, side, size):
method = "POST"
request_path = "/api/v5/trade/order"
timestamp = str(time.time())
body = {
"instId": symbol, # 交易对，如BTC-USDT
"tdMode": "cash", # 保证金模式
"side": side, # buy或sell
"ordType": "market", # 市价单
"sz": size # 数量
}
body_json = json.dumps(body)
sign = get_sign(timestamp, method, request_path, body_json)
headers = {
"OK-ACCESS-KEY": api_key,
"OK-ACCESS-SIGN": sign,
"OK-ACCESS-TIMESTAMP": timestamp,
"OK-ACCESS-PASSPHRASE": passphrase,
"Content-Type": "application/json"
}
response = requests.post(base_url + request_path, data=body_json, headers=headers)
return response.json()
提示：首次运行建议使用极小金额（如0.0001 BTC）测试,避免资金损失。
2 限价单逻辑
将 ordType 改为 "limit"，并添加 px 参数（限价价格）即可，完整示例可参考欧易API文档。
常见问题与错误排查
| 错误码 | 含义 | 解决方案 |
|---|---|---|
| 40001 | API Key无效 | 检查Key是否正确复制 |
| 40002 | 签名错误 | 确认Secret Key与passphrase无误 |
| 40003 | 权限不足 | 在API管理页面开启交易权限 |
| 50000 | 系统繁忙 | 稍后重试 |
关键安全提示：
- 切勿将Secret Key明文存入公开仓库（如GitHub）。
- 建议使用环境变量存储敏感信息：
import os api_key = os.getenv("OKX_API_KEY")
问答环节：解答高频疑问
问：欧易API调用有频率限制吗？
答：有，公共接口限制为20次/秒，私有接口（如交易与账户）限制为10次/秒，超出限制将返回429错误，建议在脚本中添加延时（time.sleep(0.1)）。
问：如何通过API获取实时行情数据？
答：使用公开接口 /api/v5/market/ticker 即可，无需API Key。
response = requests.get("https://www.okx.com/api/v5/market/ticker?instId=BTC-USDT")
print(response.json())
问：脚本中必须使用IP白名单吗？
答：非强制，但强烈推荐，绑定IP后，即使API Key泄露,攻击者也无法从其他IP发起请求。
问：在哪里可以找到官方API文档？
答：您可访问欧易交易所下载并进入“开发者文档”板块,获取完整的接口列表与参数说明。
通过本文教程，您已掌握欧易API接口申请的完整流程，并成功使用Python编写了账户查询与交易脚本，量化交易之路需要不断实践与优化，建议先在模拟盘测试代码，再逐步过渡到实盘，请始终牢记：安全是交易的第一要务,严格保护您的API密钥。
打开欧易官网,创建您的第一个交易机器人吧！
标签： 欧易API Python交易脚本
