Initial CoinOX instance: coin-margined options + USDT hedge.

Forked from crypto_monitor OKX instance (copy-only). Keeps standalone options, perp-options and options-options hedge; drops standalone perp entrypoints; forces coin margin; adds sim wallets; default port 5010.

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

docs/期权用法.md

@@ -0,0 +1,107 @@
+# OKX 期权 — 使用说明
+
+## 1. 前置条件
+
+1. OKX 账户已开通期权(USDⓈ 本位),且 App 中可见 `ETHUSD UM` / `BTCUSD UM`.
+2. 在 `crypto_monitor_okx/.env` 配置 **唯一账户 API**(永续与期权共用):
+
+```bash
+OKX_API_KEY=你的账户Key
+OKX_API_SECRET=...
+OKX_API_PASSPHRASE=...
+OKX_OPTIONS_ENABLED=true
+```
+
+3. 重启实例:`pm2 restart crypto_okx --update-env`
+
+> 旧 `OKX_OPTIONS_API_*` 已废弃.若仅残留 OPTIONS 键而 `OKX_API_*` 为空,启动会自动回填.
+
+## 2. 资金准备
+
+期权权利金使用 **USDC**,不能直接用 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. 本轮只按买一深度限价卖出;买一不够则剩余下次再平
+4. **市价平仓已禁用**(代码硬关闭)
+
+目标位自动平另需「可回收 ≥ 2×权利金并持续约 2 分钟」;细则见独立说明:
+
+- 仓库文档:[期权开平仓与监控说明.md](./期权开平仓与监控说明.md)
+- 线上(登录后):`/options/guide`
+
+## 5. 微信提醒
+
+需已配置 `WECHAT_WEBHOOK`.
+
+| 场景 | 标题 | 说明 |
+|------|------|------|
+| **开仓** | 【OKX期权·开仓】 | 下单成功并写入本地后必发(幂等) |
+| **平仓** | 【OKX期权·平仓】 | 手动全平 / 目标位全平 / 到期或交易所平仓同步后必发(幂等) |
+| 浮盈翻倍 | 【OKX期权·翻倍提醒】 | 未实现盈亏 ≥ 已付权利金约 100%,同一笔只提醒一次 |
+| 挂单超时撤销 | 【OKX期权·挂单超时撤销】 | 平仓挂单超时被系统撤销 |
+
+## 6. 与永续 / 对冲计划的关系
+
+| | 永续 | 期权 |
+|--|------|------|
+| API | `OKX_API_*`(同一套) | `OKX_API_*`(同一套) |
+| 页面 | 实盘下单 / 关键位 | 期权 · 对冲计划 |
+| 顶栏 | USDT 资金户+交易户 | USDC 期权资金+期权交易 |
+
+**期期对冲张数**(对冲计划页,与单独开期权共用预算算法):
+
+| 模式 | 说明 |
+|------|------|
+| 同张数(默认) | 两腿同 `n`,总权利金 ≤ 预算 |
+| 按比例 | 主腿/次腿按 `HEDGE_PLAN_OO_BIAS_*` |
+
+## 7. 常见问题
+
+**Q:以前的期权专用密钥还要配吗?**  
+- 不需要.统一写到 `OKX_API_*`.
+
+**Q:还能主↔子划转吗?**  
+- 已移除.只保留同账户内划转与币种兑换.