ouyi交易所API接口文档：创建和管理API密钥完整指南
发布者：易欧交易注册地址网技术团队
更新时间：2026年1月15日
更新时间：2026年1月15日
API密钥简介
API密钥是连接您与ouyi交易所系统的桥梁，允许您通过编程方式访问市场数据、执行交易和管理账户。正确创建和管理API密钥对于保障您的资产安全至关重要。
交易自动化
实现24/7不间断交易策略执行
数据获取
实时获取市场数据和账户信息
应用集成
与交易工具和分析平台无缝对接
第一步：创建API密钥
以下是创建ouyi交易所API密钥的详细步骤：
1
登录您的ouyi账户
前往http://www.workshopsbali.com/并通过账户名和密码登录。建议使用官方APP的二次验证提高安全性。
2
进入API管理页面
登录后，点击右上角用户头像，选择"API管理"或直接访问http://www.workshopsbali.com//api/manage。
3
创建新API密钥
点击"创建API"按钮，系统会提示您设置API密钥名称和权限。
权限说明：
- 读取权限：仅查看账户和市场数据
- 交易权限：可下单和修改订单
- 提现权限：可转移资产（高危，不建议开启）
4
设置IP白名单（可选但强烈推荐）
为增强安全性，您可以指定允许调用此API的IP地址，多个IP用逗号分隔。
5
获取API密钥和私钥
确认后系统将生成API Key和Secret Key，这是唯一一次完整显示Secret Key的机会，请妥善保存。
重要安全提示：
- Secret Key一旦离开此页面将无法再次完整查看
- 建议将密钥保存在安全的密码管理器中
- 切勿通过邮件或即时通讯工具发送密钥
- 启用IP限制可以有效防止密钥泄露后的滥用
第二步：API密钥管理
创建API密钥后，良好的管理习惯能帮助您有效控制风险。
安全警告
如果怀疑API密钥可能已经泄露，请立即删除所有相关API密钥并重新创建。同时检查账户活动记录是否有异常。
密钥轮换流程
1
创建新的API密钥并更新所有使用该密钥的应用程序
2
测试新密钥确保所有功能正常工作
3
删除旧密钥
权限管理最佳实践
| 应用场景 | 推荐权限 | 不建议开启 |
|---|---|---|
| 市场数据分析 | 只读访问 | 交易、提现 |
| 交易机器人 | 交易 | 提现 |
| 资产管理系统 | 只读访问 | 交易、提现 |
API使用示例
以下是一些常见的API调用示例，帮助您快速上手。
获取市场数据
import requests
url = "https://api.ouyi.com/api/v1/market/tickers"
headers = {
"Content-Type": "application/json",
"X-API-KEY": "your_api_key_here"
}
response = requests.get(url, headers=headers)
print(response.json())安全签名请求示例
对于涉及敏感操作的API调用，需要使用私钥生成签名。
import hmac
import hashlib
import time
api_key = "YOUR_API_KEY"
secret_key = "YOUR_SECRET_KEY"
timestamp = int(time.time() * 1000)
method = "POST"
path = "/api/v1/order"
message = str(timestamp) + method + path + '{"symbol":"BTC_USDT","type":"limit"...}'
signature = hmac.new(secret_key.encode(), message.encode(), hashlib.sha256).hexdigest()
headers = {
"X-API-KEY": api_key,
"X-TIMESTAMP": str(timestamp),
"X-SIGNATURE": signature
}
专业提示： 官方提供了多种语言的SDK，可直接处理签名逻辑，推荐使用而不是自行实现。
常见问题解答
401错误通常表示认证失败，请检查：
- API Key是否正确
- 请求头是否包含正确的X-API-KEY
- 如果是签名请求，检查时间戳是否在服务器允许的偏差范围内（通常±30秒）
- 确认IP白名单设置（如启用）是否包含当前调用IP
由于安全考虑，系统不会存储可读的Secret Key，因此无法找回。您需要：
- 删除现有API密钥
- 创建新的API密钥
- 更新所有使用该密钥的应用配置
ouyi交易所对不同API端点有不同的频率限制：
- 公开数据API：10次/秒/IP
- 账户相关API：5次/秒/API Key
- 交易相关API：3次/秒/API Key
超过限制会导致临时封禁，建议实现适当的请求节流和错误处理。