dekun
d4eb6832b7
Remove obsolete strategy, key auto-order, and AI review sections. Co-authored-by: Cursor <cursoragent@cursor.com>
188 lines
7.4 KiB
Markdown
188 lines
7.4 KiB
Markdown
# 使用说明
|
||
|
||
**仓库:** [https://git.bz121.com/dekun/crypto_okx.git](https://git.bz121.com/dekun/crypto_okx.git)
|
||
|
||
基于 Flask 的 **OKX 期权 / 对冲** Web 控制台.与中控、其它交易所实例无关.
|
||
|
||
**部署 / PM2 / SOCKS** 见 **[部署文档.md](./部署文档.md)**:
|
||
|
||
```bash
|
||
curl -fsSL https://git.bz121.com/dekun/crypto_okx/raw/branch/main/deploy/manage.sh | bash
|
||
```
|
||
|
||
默认访问: `http://<服务器IP>:5004` → 首页跳转 **期权** `/options`.
|
||
|
||
---
|
||
|
||
## 1. 能做什么
|
||
|
||
| 模块 | 路由 | 说明 |
|
||
|------|------|------|
|
||
| **期权** | `/options` | 看期权链、开平仓、持仓监控(翻倍出场等) |
|
||
| **期权复盘** | `/options/review` | 期权成交记录 → 复盘表单 → 复盘列表与统计 |
|
||
| **对冲计划** | `/hedge-plan` | 永期对冲或期期对冲:测算、启动、进行中/历史/统计 |
|
||
| **模拟资金** | 系统设置 → 模拟资金 | 本地钱包撮合,吃公开买卖一,**不下真实交易所单** |
|
||
| **env 配置** | `/env_config` | 浏览器改 `.env`(API、交易模式、预算等) |
|
||
| **系统设置** | `/settings` | 导航显示、模拟/实盘、密码、划转、导出等 |
|
||
|
||
顶栏还可按需显示:关键位监控(提醒)、数据看板、账户流水、风控说明等(在 **系统设置 → 导航显示** 开关).
|
||
|
||
**已移除:** 策略交易、关键位自动下单、永续实盘下单页、永续交易记录/复盘、AI 复盘、中控对接.
|
||
|
||
---
|
||
|
||
## 2. 登录与顶栏
|
||
|
||
1. 打开站点 → 登录(`APP_USERNAME` / `APP_PASSWORD`,见 `.env`).
|
||
2. 顶栏标题区显示交易所名;若为模拟模式会标 **模拟**.
|
||
3. 资金条含:总资金、资金/交易账户(USDT)、期权资金/交易账户(USDC)、实时盈亏等(模拟/实盘数据源不同).
|
||
|
||
---
|
||
|
||
## 3. 交易模式(必读)
|
||
|
||
在 **env 配置** 或 `.env` 中设置 **`OKX_TRADE_MODE`**(多数可热更,启用类开关改后建议重启):
|
||
|
||
| 值 | 含义 |
|
||
|----|------|
|
||
| `options` | **单独期权**:可单独开期权;隐藏对冲导航 |
|
||
| `perp_options` | **永期对冲**:不可单独开期权;对冲页显示「永期对冲」 |
|
||
| `options_options` | **期期对冲**:不可单独开期权;对冲页显示「期期对冲」 |
|
||
|
||
对冲模式下期权页仍可查看/平仓已有仓,但不能单独新开期权.
|
||
|
||
对冲与单独期权默认可互斥(`HEDGE_PLAN_OPTIONS_MUTUAL_EXCLUSIVE=true`):有对冲计划时不可单独开期权,有单独期权时不可启动对冲.
|
||
|
||
---
|
||
|
||
## 4. 期权页(`/options`)
|
||
|
||
### 4.1 前置
|
||
|
||
- `OKX_OPTIONS_ENABLED=true`(默认 true)
|
||
- 已配置 `OKX_API_KEY` / `OKX_API_SECRET` / `OKX_API_PASSPHRASE`(永续与期权共用)
|
||
- 实盘真下单需 `LIVE_TRADING_ENABLED=true`;否则多为本地流程/模拟(见第 7 节)
|
||
- 期权账户为 **USDC**;永续腿为 **USDT**,资金不互通
|
||
|
||
### 4.2 开仓流程
|
||
|
||
1. 选标的 **ETH / BTC**、到期日.
|
||
2. **列表** 或 **T 型** 看链;可筛看涨/看跌、实值/虚值;勾选「展开全部」看全部行权价.
|
||
3. 环境「链上仅显示有卖一」开启时,无真实卖一或深度不足 1 张的合约会隐藏.
|
||
4. 点某行 **买入** → 下单面板确认张数、权利金、到期平衡等.
|
||
5. 张数:「按可用余额打满」受单笔预算 `OKX_OPTIONS_TRADE_BUDGET_USDC` × 缓冲 `OKX_OPTIONS_BUDGET_BUFFER` 限制;「全仓复利」用交易户全部可用(可设全仓上限),且通常仅允许同时 1 笔持仓.
|
||
6. 可勾选 **翻倍出场**(盈利达权利金倍数后限价平).
|
||
|
||
### 4.3 持仓与平仓
|
||
|
||
- 右侧/下方持仓卡可改翻倍倍数或关闭、执行平仓.
|
||
- 平仓默认买一限价;是否允许市价平见 `OKX_OPTIONS_ALLOW_MARKET_CLOSE`.
|
||
- 页面内「开仓规则说明」与 `/options/guide` 有更细规则.
|
||
|
||
---
|
||
|
||
## 5. 期权复盘(`/options/review`)
|
||
|
||
1. **交易记录**:筛选期权成交/平仓记录.
|
||
2. **复盘表单**:选中一笔填写复盘内容并保存.
|
||
3. **复盘记录 / 统计**:查看已复盘条目与汇总.
|
||
|
||
该页只覆盖期权侧,不含已移除的永续交易日记账.
|
||
|
||
---
|
||
|
||
## 6. 对冲计划(`/hedge-plan`)
|
||
|
||
需将 `OKX_TRADE_MODE` 设为 `perp_options` 或 `options_options`.
|
||
|
||
### 6.1 页签
|
||
|
||
| Tab | 说明 |
|
||
|-----|------|
|
||
| 永期对冲 | 期权腿 + 永续腿(仅 `perp_options`) |
|
||
| 期期对冲 | 双期权腿(仅 `options_options`) |
|
||
| 进行中的计划 | 盯盘 / 开仓中 / 半腿 / 持仓中 |
|
||
| 历史记录 | 已结束计划 |
|
||
| 统计分析 | 对冲结果汇总 |
|
||
|
||
### 6.2 永期对冲要点
|
||
|
||
- **账户**:永续 → 合约账户(USDT);期权 → 期权账户(USDC).
|
||
- **以期权为主**(`HEDGE_PLAN_OPTION_PRIMARY=true`):填参后「策略启动」进入盯盘,条件达标后自动先开期权再市价永续.
|
||
- **保险模式**(`HEDGE_PLAN_OPTION_PRIMARY=false`):做多配 Put、做空配 Call;现场按开仓价与止盈止损执行,交易所 TP/SL 出场.
|
||
- 组数上限:`MAX_ACTIVE_HEDGE_PLANS`(默认 1).
|
||
|
||
### 6.3 期期对冲要点
|
||
|
||
- 按预算或张数拆分主/次腿(见 `HEDGE_PLAN_OO_BIAS_*`).
|
||
- 平仓模式(到期平 / 全平等)受 `HEDGE_PLAN_OO_CLOSE_MODE_ENABLED` 控制.
|
||
|
||
### 6.4 半腿
|
||
|
||
一侧成交、另一侧失败时,默认可挂 `partial` 在页面 **手动补开**(`HEDGE_PLAN_MANUAL_COMPLETE_ON_PARTIAL=true`),避免误自动平掉已成腿.
|
||
|
||
真下单还需 `HEDGE_PLAN_LIVE_ORDER=true` 与 `LIVE_TRADING_ENABLED=true`(以 env 为准).
|
||
|
||
---
|
||
|
||
## 7. 模拟资金 vs 实盘
|
||
|
||
**系统设置 → 模拟资金**:
|
||
|
||
| 操作 | 说明 |
|
||
|------|------|
|
||
| 切换到模拟资金 | 本地 SQLite 钱包;用 OKX **公开行情** 吃买卖一结算,**不向交易所下真实单** |
|
||
| 切换到实盘 | 走真实 API(须密钥正确且允许实盘) |
|
||
| 重置权益 | 无仓时可重置;强制重置会清仓 |
|
||
| 划转 / USDT↔USDC | 仅作用于模拟钱包 |
|
||
|
||
启动默认模式:`SIM_DEFAULT_MODE=sim` 或 `live`.顶栏出现 **模拟** 徽章即表示当前为模拟.
|
||
|
||
---
|
||
|
||
## 8. 系统设置与 env
|
||
|
||
### 系统设置(`/settings`)
|
||
|
||
- **导航显示**:开关顶栏各入口
|
||
- **模拟资金**:见上节
|
||
- **账户密码**:改登录口令
|
||
- **永续划转 / 期权划转 / 币种兑换**:实盘账户内资金操作(模拟模式有对应模拟划转)
|
||
- **数据导出**:导出相关 CSV
|
||
|
||
### env 配置(`/env_config`)
|
||
|
||
常用项:
|
||
|
||
| 类别 | 变量示例 |
|
||
|------|----------|
|
||
| 登录 | `APP_PASSWORD`,`FLASK_SECRET_KEY` |
|
||
| API | `OKX_API_*`,`OKX_TD_MODE`,`OKX_POS_MODE` |
|
||
| 代理 | `OKX_SOCKS_PROXY=socks5h://127.0.0.1:1080` |
|
||
| 实盘开关 | `LIVE_TRADING_ENABLED` |
|
||
| 模式 | `OKX_TRADE_MODE` |
|
||
| 期权预算 | `OKX_OPTIONS_TRADE_BUDGET_USDC`,`OKX_OPTIONS_COMPOUND_FULL_*` |
|
||
| 对冲 | `HEDGE_PLAN_*`,`MAX_ACTIVE_HEDGE_PLANS` |
|
||
| 企业微信 | `WECHAT_WEBHOOK` |
|
||
|
||
完整注释见根目录 **`.env.example`**.`.env` 勿提交 Git;`git pull` 不会覆盖本地 `.env`.
|
||
|
||
---
|
||
|
||
## 9. 首次上手建议
|
||
|
||
1. 部署并打开站点,登录后到 **系统设置 → 模拟资金**,确认处于 **模拟**.
|
||
2. **env 配置** 填 API(模拟下单可不真下交易所,但拉链/行情通常仍需可达 OKX;本机受限时配 SOCKS).
|
||
3. 设 `OKX_TRADE_MODE=options`,在 **期权** 页熟悉开平仓与持仓卡.
|
||
4. 需要复盘时用 **期权复盘**.
|
||
5. 再按需改成永期/期期对冲,先模拟跑通再切实盘.
|
||
6. 实盘前再开 `LIVE_TRADING_ENABLED` / `HEDGE_PLAN_LIVE_ORDER`,并确认 OKX 权限、持仓模式、IP 白名单.
|
||
|
||
---
|
||
|
||
## 10. 风险与合规
|
||
|
||
- 期权与永续杠杆风险高,实盘盈亏自负.
|
||
- 勿把 `.env`、API 密钥提交到仓库或发到公网.
|
||
- 请遵守当地法规与 OKX 用户协议;本说明仅描述产品用法,不构成投资建议.
|