# OKX 期权 — 使用说明

## 1. 前置条件

1. OKX **主账户**已开通期权（USDⓈ 本位），且 App 中可见 `ETHUSD UM` / `BTCUSD UM`。
2. 在 `crypto_monitor_okx/.env` 配置 **期权专用 API**（与永续子账户分开）：

```bash
OKX_OPTIONS_ENABLED=true
OKX_OPTIONS_API_KEY=你的主账户Key
OKX_OPTIONS_API_SECRET=...
OKX_OPTIONS_API_PASSPHRASE=...
```

3. 重启实例：`pm2 restart crypto_okx`

> 永续仍用原有 `OKX_API_*`（子账户）；期权只用 `OKX_OPTIONS_API_*`（主账户）。

## 2. 资金准备

期权权利金使用 **USDC 或 USDG**，不能直接用 USDT 买入。

### 推荐步骤

1. 打开 **期权** 页，查看顶栏：
   - **资金账户**：USDT 余额
   - **交易账户**：USDC 余额（买期权从这里扣）
2. **币种兑换**（资金账户内）  
   - 从 USDT 兑换为 USDC  
   - 先点 **询价**，确认预估获得量后点 **确认兑换**
3. **账户划转**  
   - 从：资金账户 → 到：交易账户  
   - 币种：USDC  
   - 将兑换得到的 USDC 划到交易账户
4. 确认 **交易账户 USDC** 足够支付本笔权利金

系统 **不会** 自动兑换或划转，避免误动资金。

## 3. 下单流程

1. 顶栏进入 **期权**
2. 选择 **ETH** 或 **BTC**
3. 选择 **到期日**（默认仅 1～2 日）
4. 选择 **看涨 Call** 或 **看跌 Put**
5. 在行权价列表中选 **轻度实值** 合约
6. 查看：
   - **卖一价**（每 1 ETH/BTC 的报价）
   - **张数 / ETH 数量**
   - **预估权利金**（USDC）
7. 选择 **按预算打满**（默认 10U×0.95）或 **指定 ETH 数量**
8. 点击 **限价买入**（价格 = 卖一）

### 张数说明

- **1 张 = 0.01 ETH**（或 0.01 BTC）— 与 OKX App「合约价值」一致
- 盘口报价是 **每 1 ETH** 的价格  
  例：报价 15.6，买 0.5 ETH（50 张）→ 权利金 ≈ 15.6 × 0.5 = **7.8 USDC**

## 4. 持仓与平仓

持仓表字段对齐 OKX：合约、张数、开仓均价、标记价、浮盈、收益率、到期等。

**平仓（锁利/止损）：**

1. 在持仓行点击 **平仓**
2. 查看 **买一价** 与预估收回
3. 确认 **限价卖出**（价格 = 买一）

> 默认不使用市价平仓。若 `.env` 开启 `OKX_OPTIONS_ALLOW_MARKET_CLOSE=true`，市价按钮会出现并带风险提示。

## 5. 微信提醒

当某笔持仓 **未实现盈亏 ≥ 已付权利金的 100%**（翻倍）时，会发 **一条** 企业微信提醒（同一笔只提醒一次）。

需已配置 `WECHAT_WEBHOOK`。

## 6. 与永续的关系

| | 永续（子账户） | 期权（主账户） |
|--|----------------|----------------|
| API | `OKX_API_*` | `OKX_OPTIONS_API_*` |
| 页面 | 实盘下单 / 关键位 | 期权 |
| 资金顶栏 | USDT 资金户+交易户 | 期权页单独显示 USDC 等 |

两套资金 **不合并** 显示。

## 7. 配置说明

| 变量 | 默认 | 含义 |
|------|------|------|
| `OKX_OPTIONS_TRADE_BUDGET_USDC` | 10 | 单笔权利金上限 |
| `OKX_OPTIONS_BUDGET_BUFFER` | 0.95 | 算张数时预留 5% 缓冲 |
| `OKX_OPTIONS_MAX_DTE_DAYS` | 2 | 最多选几天内到期 |
| `OKX_OPTIONS_ITM_MAX_DIST_USD` | 30 | 轻度实值：价内不超过多少 USD |
| `OKX_OPTIONS_PROFIT_ALERT_RATIO` | 1.0 | 浮盈/权利金 ≥ 此值推送 |

## 8. 常见问题

**Q：为什么买不了？**  
- 交易账户 USDC 不足 → 先兑换再划转  
- 卖一价过高，10U 预算买不到 1 张 → 选更便宜合约或提高 `OKX_OPTIONS_TRADE_BUDGET_USDC`  
- 期权 API 未配置或 `OKX_OPTIONS_ENABLED=false`

**Q：报价 15 是每张 15U 吗？**  
- 不是。15 是 **每 1 ETH** 的报价；每张（0.01 ETH）约 0.15 USDC。

**Q：子账户能开期权吗？**  
- 本系统期权走主账户 API；子账户永续不受影响。

## 9. 风险说明

- 买方最大亏损为 **权利金**；近期实值仍会时间衰减  
- 限价单可能因无流动性未成交  
- 请先在小额下验证兑换、划转、开平仓全流程
