dekun
afe361ce47
Add UI switch for Call+short/Put+long, premium x0.95 sizing, option-first open, and K+/-points exits with fee-aware net PnL. Co-authored-by: Cursor <cursoragent@cursor.com>
70 lines
2.5 KiB
Markdown
70 lines
2.5 KiB
Markdown
# 对冲计划 · 永期「以期权为主」
|
||
|
||
> 实现日:2026-08-09 · 在现有永期**保险模式**上增加计划级开关,不新增 `OKX_TRADE_MODE`。
|
||
|
||
## 1. 模式对照
|
||
|
||
| | 保险模式(开关关) | 以期权为主(开关开) |
|
||
|--|------------------|-------------------|
|
||
| UI 做多 | 永续多 + 买 Put | 买 Call + 永续空 |
|
||
| UI 做空 | 永续空 + 买 Call | 买 Put + 永续多 |
|
||
| 左卡 | 开仓价 / 张数 / TP / SL | 权利金 / 杠杆 / 比例 / 到期h / 间隔 / 目标点数 |
|
||
| 选约 | 仅实值/平值 | 实/平/虚 + 间隔 + 杠杆门 |
|
||
| 开仓 | 受 `HEDGE_PLAN_OPEN_ORDER` | **强制先期权**,成交后**立即市价**开永续(**不挂**交易所 TP/SL) |
|
||
| 出场 | 交易所 TP/SL | 相对 K 的点数目标分叉 |
|
||
|
||
## 2. 左卡默认
|
||
|
||
| 字段 | 默认 |
|
||
|------|------|
|
||
| 权利金 | 用户填(USDC 预算) |
|
||
| 永续杠杆 | 100 |
|
||
| 期权杠杆 | 实/平 100;虚 200 |
|
||
| 期权:永续比例 | 实/平 2;虚 4 |
|
||
| 到期时间(最短 h) | 36 |
|
||
| 期权间隔(点) | 15 |
|
||
| 期权/永续目标位 | 相对 K 点数,须 **>0** |
|
||
|
||
## 3. 定仓
|
||
|
||
```
|
||
usable = 权利金 × 0.95
|
||
eth_qty = floor2(usable / ask) # ETH 名义,两位小数
|
||
sheets = floor(eth_qty / ct_mult) # 整张
|
||
perp_eth = eth_qty / 比例
|
||
contracts = perp_eth / contract_size
|
||
```
|
||
|
||
启动前再拉卖一重算;卖一深度不足则缩量。
|
||
|
||
## 4. 出场
|
||
|
||
触达任一目标位(做多 `index ≥ K+N`,做空 `index ≤ K−N`)后立即执行:
|
||
|
||
| 触达 | 规则 |
|
||
|------|------|
|
||
| **期权目标** | 验买一流动性 + **扣费净利 > 0** → 先平期权再平永续 |
|
||
| **永续目标** | 市价平永续;期权 `hold_to_expiry` 至到期结算 |
|
||
|
||
净利:平仓/卖出手续费**按买入费率**估算(`HEDGE_PLAN_FEE_RATE` / `OKX_TAKER_FEE`,默认 0.0005)。
|
||
|
||
若期权目标因买一/净利未过、但永续目标已触达 → 改走永续目标。
|
||
期权已平永续失败 → `opt_target_perp_pending` 下轮只补平永续。
|
||
两腿仍开但期权到期 → 结算期权并平永续,避免裸奔。
|
||
|
||
## 5. 代码落点
|
||
|
||
| 文件 | 作用 |
|
||
|------|------|
|
||
| `lib/hedge_plan/hedge_plan_option_primary_lib.py` | 定仓/方向/目标/净利/校验 |
|
||
| `hedge_plan_orders_lib.py` | 路径、开平永续、启动前定仓刷新 |
|
||
| `hedge_plan_monitor_lib.py` | `_tick_po_option_primary*` |
|
||
| `hedge_plan_register.py` / `hedge_plan_db.py` | preview/start/persist 列 |
|
||
| `hedge_plan.js` + `hedge_plan_panel.html` | 开关与左右卡 |
|
||
|
||
## 6. 测试
|
||
|
||
```bash
|
||
python -m unittest tests.test_hedge_plan_option_primary -v
|
||
```
|