Add OKX options hedge strategy guide for manual perp and options pairing.

Co-authored-by: Cursor <cursoragent@cursor.com>

docs/期权对冲方案分析.md

@@ -0,0 +1,322 @@
+# 期权对冲方案分析
+
+> 适用范围:OKX **永续子账户**(USDT 本位) + **期权主账户**(USDⓈ 本位买方).  
+> 本文档为 **策略与操盘说明**,非系统自动下单功能;组合须 **人工** 在永续页与期权页分别执行.
+
+---
+
+## 1. 前提与账户分工
+
+| 维度 | 永续合约(子账户) | 期权(主账户) |
+|------|------------------|--------------|
+| API | `OKX_API_*` | `OKX_OPTIONS_API_*` |
+| 系统页面 | 实盘下单 / 关键位 / 策略 | 期权 |
+| 保证金 | USDT | USDC / USDG |
+| 本系统能力 | 开平仓、止损、关键位 | **仅买方** 开平仓,无组合单 |
+
+**重要约束:**
+
+- 两套资金 **不自动合并**;对冲是逻辑上的组合,资金与下单 **分账户** 管理.
+- 系统 **不支持** 卖方开仓、跨式组合单、自动 Delta 调仓;下文操盘均为 **手工流程**.
+- 期权模块默认:≤2 日到期、轻度实值、单笔权利金预算(如 10 USDC).对冲设计需与此预算协调.
+
+---
+
+## 2. 期权 + 永续合约对冲
+
+指用 **期权买方头寸** 去对冲或替代 **永续方向敞口**,降低单边暴跌/暴涨带来的尾部风险,或锁定部分利润.
+
+### 2.1 使用场景
+
+| 场景 | 永续侧状态 | 期权侧动作 | 目的 |
+|------|------------|------------|------|
+| **保护性 Put** | 子账户 **多头** 永续(策略/关键位持仓) | 主账户买入 **看跌 Put**(轻度实值、近月) | 大跌时 Put 升值,抵消永续浮亏 |
+| **看涨保险** | 子账户 **空头** 永续 | 主账户买入 **看涨 Call** | 急涨时 Call 升值,限制空头亏损 |
+| **事件前对冲** | 永续有仓,临近 FOMC/CPI/非农 | 临时买 **Put 或 Call**(方向视净敞口) | 降低数据公布瞬间波动伤害 |
+| **锁利减仓** | 永续浮盈较大,不愿全平 | 买 **反向期权** 作「便宜保险」 | 保留永续吃趋势,用权利金买回撤保护 |
+| **替代硬止损** | 永续止损易被扫或滑点大 | Put/Call 权利金 ≈ 可接受最大额外损失 | 用期权时间价值换「软止损」 |
+
+**不适合:**
+
+- 长期持仓 + 远期期权(本系统偏 ≤2 日 DTE,时间价值流失快).
+- 指望「完全对冲」零波动:买方期权有 **Theta 衰减**,永续有 **资金费**,不可能完美镜像.
+- 资金不足:期权需先 **USDT→USDC 兑换 + 划转到交易户**,再下单.
+
+### 2.2 案例分析
+
+#### 案例 A:保护性 Put(多头永续 + 买 Put)
+
+**背景**
+
+- 子账户 ETH 永续 **多 0.5 ETH**,均价 3,200,浮盈 +5%.
+- 当晚有宏观数据,担心 30 分钟内急跌 3%～8%.
+
+**操作**
+
+1. 永续:维持多单,或略减杠杆(系统「实盘下单」/策略仓).
+2. 期权主账户:USDT→USDC→划转到交易户.
+3. 期权页:ETH **看跌 Put**,行权价略低于现价(轻度实值),1～2 日到期.
+4. 按预算 10 USDC 买满(约 0.0x ETH 名义),记录权利金 **C**.
+
+**结果推演**
+
+| ETH 走势 | 永续盈亏(示意) | Put 盈亏(示意) | 组合效果 |
+|----------|----------------|----------------|----------|
+| 横盘 | 小亏资金费 | Put 因 Theta 贬值 | 净成本 ≈ 权利金 C |
+| 跌 5% | 永续大亏 | Put 明显升值 | 部分对冲,净亏 < 无 Put |
+| 涨 3% | 永续盈利 | Put 接近归零 | 永续盈利 − C |
+
+**要点:** 买的是 **保险**,不是赚钱工具;权利金 C 是「保费」.
+
+#### 案例 B:空头永续 + 买 Call
+
+**背景**
+
+- 子账户 BTC 永续 **空 0.02 BTC**,判断短期震荡偏空,但担心消息拉升.
+
+**操作**
+
+- 买 **看涨 Call**(轻度实值、近月),权利金控制在预算内.
+
+**结果推演**
+
+- 下跌:永续盈利,Call 损耗 → 净赚略少于裸空.
+- 急涨:永续亏损,Call 盈利 → 涨幅越大对冲越有效.
+
+#### 案例 C:事件窗口「临时对冲」
+
+**背景**
+
+- 永续多仓持有中,事件前 2 小时不想平仓(怕踏空).
+
+**操作**
+
+- 事件前:买小仓位 Put,事件后 1～2 小时内无论盈亏 **平掉 Put**.
+- 永续:按原策略止损/止盈,不因期权改变永续规则.
+
+**要点:** 短期 Put 的 Theta 极快;**事件结束尽快平仓**,避免「保险变持仓」.
+
+### 2.3 风险评估
+
+| 风险类型 | 说明 | 等级 |
+|----------|------|------|
+| **权利金损耗(Theta)** | 买方期权每天衰减;横盘即亏保费 | 高 |
+| **对冲比例不足** | 10U 预算买到的名义远小于永续仓位 | 高 |
+| **方向错配** | 多头却买 Call、空头却买 Put | 高 |
+| **双账户操作延迟** | 永续已亏,期权尚未成交 | 中 |
+| **流动性** | 限价未成交,极端行情无法对冲 | 中 |
+| **资金费 vs 保费** | 长期持仓资金费 + 反复买 Put 成本叠加 | 中 |
+| **汇率/币种** | 永续 USDT、期权 USDC,汇率波动次要 | 低 |
+| **API/权限** | 子账户与主账户密钥混用 | 低(配置隔离即可) |
+
+**风险量化思路(手工估算):**
+
+```
+可接受保费上限 ≈ 永续名义价值 × 愿意承担的单日额外损失比例
+例:0.5 ETH × 3,200 × 0.5% ≈ 8 USDC → 与 OKX_OPTIONS_TRADE_BUDGET_USDC 对齐
+```
+
+若保费 << 永续风险敞口,属于 **部分对冲**,需心里有数.
+
+### 2.4 操盘说明(期权 + 永续)
+
+**准备(每次对冲前)**
+
+1. 确认子账户永续:**方向、数量、均价、浮盈亏**(实盘顶栏/持仓).
+2. 确认主账户期权:**交易户 USDC 余额** 足够(兑换+划转).
+3. 明确本次是 **保护多仓(Put)** 还是 **保护空仓(Call)**.
+
+**执行顺序(推荐)**
+
+```
+① 永续侧:确认仓位与风控(止损/关键位)已就绪
+② 主账户:资金户 USDT → USDC(币种兑换) → 划转到交易户
+③ 期权页:选标的(ETH/BTC) → 到期日(1～2日) → Call/Put → 轻度实值行权价
+④ 限价买入(卖一),成交后记录:张数、权利金、行权价、到期时间
+⑤ 企业微信:关注翻倍提醒(浮盈≥100%权利金)作为减仓信号,非必须平永续
+```
+
+**平仓/退出**
+
+| 情况 | 永续 | 期权 |
+|------|------|------|
+| 趋势延续、保险未触发 | 按原策略 | 临近到期或 Theta 损耗大时 **平 Put/Call** |
+| 期权浮盈翻倍(系统提醒) | 可选:减永续仓或上移止损 | **平期权锁利**,保留永续 |
+| 永续已止损离场 | 无仓 | **立即平期权**,避免裸买权衰减 |
+| 事件结束 | 照旧 | 平期权,勿长期持有近月买方 |
+
+**检查清单**
+
+- [ ] 永续方向与期权类型匹配(多→Put,空→Call)
+- [ ] 权利金 ≤ 预算,且 ≤ 心理「保费」上限
+- [ ] 成交后两边持仓在各自页面可核对
+- [ ] 到期日前 24h 评估是否平仓期权
+
+---
+
+## 3. 期权 + 期权对冲
+
+指 **仅主账户** 内,用两个(或多个)买方期权组合,表达 **波动、方向区间或尾部保护**,不直接动永续仓位.
+
+> 本系统 **仅买方**;下列组合均为 **买 Call + 买 Put** 或 **不同行权价双买**,不含卖权收权利金策略.
+
+### 3.1 使用场景
+
+| 场景 | 组合结构 | 目的 |
+|------|----------|------|
+| **Long Straddle(双买)** | 同行权附近 **Call + Put** | 赌大波动(突破),不怕方向 |
+| **Long Strangle(宽双买)** | OTM **Call + OTM Put** | 降低成本,赌更大波动才盈利 |
+| **风险逆转(买方版)** | 轻度 ITM Call + 轻度 ITM Put(不同行权) | 同时防暴涨暴跌(保费更高) |
+| **方向 + 尾部** | 主方向 Call(或 Put) + 反向少量 Put(或 Call) | 主观点明确,反向作灾难保险 |
+| **到期滚动** | 近月双买 → 波动未出则平掉 → 换远 1 日 | 控制 Theta,需严格纪律 |
+
+**不适合:**
+
+- 预期 **窄幅震荡**(双买最亏 Theta).
+- 预算只够一笔 10U(双买需 **两倍保费** 或各减半张数).
+- 把双买当「稳赚」:横盘天天亏.
+
+### 3.2 案例分析
+
+#### 案例 D:Long Strangle(赌突破)
+
+**背景**
+
+- 认为 ETH 未来 24～48h 将选方向突破,但不确定涨跌.
+- 永续不想开仓,仅用期权表达波动观点.
+
+**操作**
+
+1. 选 1～2 日到期.
+2. 买 **轻度 OTM Call**(行权价略高于现价).
+3. 买 **轻度 OTM Put**(行权价略低于现价).
+4. 各用约一半预算(如各 5 USDC),总保费 ≈ 10U.
+
+**盈亏示意**
+
+| 市场 | 结果 |
+|------|------|
+| 横盘 | Call、Put 均衰减 → **最大亏全部保费** |
+| 大涨 | Call 盈利可能覆盖 Put 亏损 |
+| 大跌 | Put 盈利可能覆盖 Call 亏损 |
+
+**要点:** 需要波动 **幅度** 超过「总保费对应的隐含波动门槛」才划算.
+
+#### 案例 E:主多观点 + 尾部 Put(期权 + 期权)
+
+**背景**
+
+- 强烈看多 24h,但怕黑天鹅砸盘.
+
+**操作**
+
+- 70% 预算买 **Call**(进攻).
+- 30% 预算买 **Put**(尾部保险).
+
+**与「永续 + Put」区别**
+
+- 不占用永续保证金,无资金费.
+- 但 **无 Delta 线性收益**:涨得慢可能 Call 仍亏 Theta.
+
+#### 案例 F:事件双买
+
+**背景**
+
+- 非农数据公布前后 2h.
+
+**操作**
+
+- 公布前 30min:Strangle 双买.
+- 公布后:波动释放则 **平盈利腿 + 平亏损腿**;勿持仓过夜除非仍看好波动.
+
+### 3.3 风险评估
+
+| 风险类型 | 说明 | 等级 |
+|----------|------|------|
+| **双倍 Theta** | 两条腿同时衰减 | 很高 |
+| **预算分裂** | 单腿名义过小,波动不够覆盖成本 | 高 |
+| **行权价选错** | Strangle 过宽,突破仍不够回本 | 高 |
+| **执行误差** | 两腿须分别下单,一腿成交一腿未成交 | 中 |
+| **IV  crush** | 事件后隐含波动率骤降,双买同时贬值 | 中 |
+| **仅买方限制** | 无法做卖方收窄成本(如 Iron Condor) | 中 |
+
+**与永续对冲对比**
+
+| 维度 | 期权 + 永续 | 期权 + 期权 |
+|------|-------------|-------------|
+| 资金账户 | 两账户 | 仅主账户 |
+| 趋势收益 | 永续线性 | 非线性,近月衰减快 |
+| 保费成本 | 永续资金费 + 期权 | 仅期权(常更高) |
+| 适合行情 | 有主仓需保 | 无仓赌波动/事件 |
+
+### 3.4 操盘说明(期权 + 期权)
+
+**预算拆分建议**
+
+```
+总预算 B (如 10 USDC)
+├── 腿 A(主观点):B × 60%～70%
+└── 腿 B(对冲/反向):B × 30%～40%
+
+双买 Strangle:各 50%,但须接受单腿名义减半
+```
+
+**执行顺序**
+
+1. 先下 **流动性更好的一腿**(通常轻度 ITM 或更近 ATM),减少单腿敞口时间.
+2. 再下第二腿;若第二腿限价未成交,评估是否撤单重报或放弃组合.
+3. 记录两笔 `options_trades` 对应关系(备注:组合 ID / 事件名).
+
+**平仓纪律**
+
+- **时间止损:** 距到期 < 12h 且未盈利 → 考虑双平,避免 Theta 加速.
+- **盈利止损:** 组合净浮盈达保费 50%～100% → 可分批平(系统翻倍提醒可作参考).
+- **单边平仓风险:** 只平盈利腿会留下裸反向腿,除非有意转方向.
+
+---
+
+## 4. 方案选型简表
+
+| 你的状态 | 推荐方案 | 理由 |
+|----------|----------|------|
+| 子账户已有永续多仓 | **永续 + Put** | 直接保护现有 Delta |
+| 子账户已有永续空仓 | **永续 + Call** | 限制逼空风险 |
+| 无永续仓,赌大波动 | **期权 Strangle** | 不付资金费,纯波动 |
+| 有方向观点,不想开永续 | **Call 或 Put 单腿** | 简单,保费可控 |
+| 宏观事件前 | **临时 Put/Call 或双买** | 短持有,事件后平 |
+| 长期持仓数月 | 本系统近月买方 **不合适** | Theta 与操作频率不匹配 |
+
+---
+
+## 5. 与本系统功能的衔接
+
+| 功能 | 对冲中的用途 |
+|------|--------------|
+| 永续「实盘下单 / 关键位 / 策略」 | 建立或管理被对冲的合约仓 |
+| 期权页链 + 限价开平仓 | 建立买方保险或双买腿 |
+| 系统设置 → 币种兑换 / 划转 | 准备 USDC 权利金 |
+| 期权顶栏资金(资金户/交易户) | 检查保费是否足够 |
+| 企业微信翻倍提醒 | 期权腿止盈参考,非永续平仓信号 |
+| 中控 / 子代理 | **不聚合期权仓**;对冲状态需人工台账 |
+
+**建议人工台账字段**
+
+- 日期、事件、永续方向与数量、期权合约与张数、权利金、计划平仓条件、实际结果.
+
+---
+
+## 6. 免责声明
+
+- 本文档为 **教育与操盘参考**,不构成投资建议.
+- 加密货币期权与永续波动极大,买方权利金可能 **全部损失**.
+- 对冲 **无法消除** 风险,只能改变风险形态;请用小资金验证全流程后再放大.
+
+---
+
+## 7. 相关文档
+
+| 文档 | 内容 |
+|------|------|
+| [期权方案.md](./期权方案.md) | 技术架构与 API |
+| [期权用法.md](./期权用法.md) | 兑换、划转、开平仓操作 |
+| [期权用法.md §9](./期权用法.md) | 基础风险说明 |