技术文档
交易所 API 获取指南与系统接口说明
系统概述
OIOption 鹰眼系统通过各大交易所的官方 API 实时采集期权和衍生品市场数据，为用户提供专业的监控、分析与决策支持。以下文档将帮助您了解如何获取交易所 API 密钥并接入系统。
数据来源
系统通过交易所公开 API 获取期权行情、持仓数据、成交记录等，所有数据均来自官方接口
支持交易所
目前支持 Deribit、OKX、Binance 三大主流交易所，覆盖 BTC/ETH 等主流品种期权数据
数据更新
系统 7×24 小时自动采集，数据延迟通常 < 5秒，确保您获取最新的市场信息
安全保障
所有 API 密钥使用 AES-256 加密存储，系统仅需只读权限，不涉及任何资金操作
交易所 API 获取指南
使用鹰眼系统前，您需要在对应交易所创建 API 密钥。以下是各交易所的详细步骤：
OKX
官方文档- 1登录 OKX 官网，进入「个人中心」→「API」
- 2点击「创建 API 密钥」，设置备注名称（如 "OIOption"）
- 3权限选择：勾选「读取」，不要勾选「交易」和「提币」
- 4设置 Passphrase（牢记此密码，后续配置需要）
- 5绑定 IP 地址（可选，增强安全性）
- 6记录 API Key、Secret Key 和 Passphrase
https://www.okx.com/account/my-apiDeribit
官方文档- 1登录 Deribit 官网，进入「My Account」→「API」标签
- 2点击「+ Add new key」创建新的 API 密钥
- 3权限配置：Scope 选择 "read" 或 "read_write"（仅监控选 read）
- 4设置 Account 范围：选择需要监控的子账户
- 5创建后系统会显示 Client ID 和 Client Secret
- 6立即保存 Client Secret（仅显示一次）
https://www.deribit.com/main#/account?tab=apiBinance
官方文档- 1登录 Binance 官网，进入「账户管理」→「API 管理」
- 2输入标签名（如 "OIOption"），点击「创建 API」
- 3完成安全验证（邮箱 + 手机/谷歌验证）
- 4权限设置：仅启用「读取信息」，关闭「现货交易」和「提现」
- 5（推荐）设置 IP 限制，仅允许服务器 IP 访问
- 6保存 API Key 和 Secret Key（Secret 仅创建时显示）
https://www.binance.com/en/my/settings/api-managementAPI 权限配置说明
为了保障您的资金安全，请严格按照以下权限要求配置 API 密钥：
获取账户信息、持仓数据、历史订单。系统的数据监控、净头寸分析、信号检测等核心功能均依赖此权限。
下单、撤单、修改订单。仅在使用系统的量化交易功能时需要开启，纯监控用户无需此权限。
系统不需要也不会使用提币权限。请务必关闭此权限，确保即使密钥泄露也不会造成资金损失。
将 API 密钥绑定到服务器 IP，即使密钥泄露也无法从其他 IP 使用，大幅提升安全性。
系统数据接口
鹰眼系统提供 RESTful API 接口，登录后通过 JWT Token 认证访问。以下为主要数据接口：
| 接口路径 | 方法 | 说明 | 认证 |
|---|---|---|---|
/api/ping | GET | 系统健康检查 | 无需 |
/api/auth/login | POST | 用户登录，获取 JWT Token | 无需 |
/api/data/options/recent | GET | 获取近期期权数据 | Bearer |
/api/data/options/statistics | GET | 获取期权统计概览 | Bearer |
/api/data/signals/recent | GET | 获取近期信号事件 | Bearer |
/api/data/net-positions/snapshot | GET | 获取净头寸快照 | Bearer |
/api/data/net-positions/grid | GET | 获取净头寸网格数据 | Bearer |
/api/data/eagle-decision/fusion | GET | 获取 Eagle 融合分析结果 | Bearer |
/api/data/visualization/anomalies | GET | 获取异常数据（可视化） | Bearer |
/api/data/kline/ohlcv | GET | 获取 K 线行情数据 | Bearer |
/api/system/health | GET | 系统状态与健康度 | Bearer |
/api/system/exchange-status | GET | 各交易所连接状态 | Bearer |
认证方式
所有需要认证的接口，请在 HTTP Header 中携带 JWT Token：
Authorization: Bearer <your_access_token>快速上手
注册账号
在官网完成注册并购买订阅套餐，获取系统访问权限
创建 API 密钥
按照上方指南，在需要监控的交易所创建 API 密钥（仅需只读权限）
配置 API
登录用户中心，在「API 配置」中填入各交易所的 API Key、Secret 和 Passphrase
进入系统
配置完成后，点击「进入主系统」开始使用 Dashboard、监控、信号分析等功能
开始使用
系统会自动开始采集数据，您可以通过各功能模块查看实时行情、异常检测、净头寸分析等
常见问题
API 密钥会被泄露吗？
所有 API 密钥采用 AES-256 加密存储，传输过程使用 TLS 加密。建议额外开启 IP 白名单并关闭提币权限，确保多重安全保障。
需要开通交易权限吗？
如果您只使用数据监控和分析功能（Dashboard、信号、净头寸等），仅需「只读」权限即可。量化交易模块需要「交易」权限。
支持哪些交易所？
目前支持 OKX、Deribit、Binance 三大交易所。Deribit 是全球最大的加密期权交易所，OKX 和 Binance 提供丰富的衍生品数据。
API 请求有频率限制吗？
系统内部已做好请求频率控制，不会超出交易所的限频规则。用户无需担心 API 被封禁。
数据延迟是多少？
数据采集延迟通常 < 5秒，系统 7×24 小时持续运行。您可在 Dashboard 页面查看各交易所的数据新鲜度。
如何更换或删除 API 密钥？
在用户中心的「API 配置」中可以随时更新或删除已保存的 API 密钥。建议定期轮换密钥以提升安全性。