# CoinOX（币本对冲）

OKX **币本位期权** + **U 本位永续对冲** 独立实例。

远程仓库：<https://git.bz121.com/dekun/CoinOX.git>

## 产品范围

本仓**仅对冲**。单独期权（含中控）请用专用期权仓库；此处默认不装单独期权交易页/独立盯盘，但装载**对冲复盘**（已结束计划 + 标的永续双周期 K 线）。

| 保留 | 说明 |
|------|------|
| 永期对冲 | 币本位期权腿 + USDT 永续腿 |
| 期期对冲 | 双腿币本位期权 |
| 模拟资金 | **默认 `sim`**，本地钱包撮合 |
| 期权执行层 | 报价/下单/买币桥，供对冲腿共用 |

| 不提供 | 说明 |
|--------|------|
| 单独期权 UI | 默认关闭；紧急可 `STANDALONE_OPTIONS_UI=true`（不推荐） |
| 单独永续下单 | `/trade` 已重定向 |
| 关键位自动开仓 | `/key_monitor` 已重定向 |
| 策略趋势/滚仓 | 未安装 |
| USDC 期权 | 已固定币本位 |
| Windows 部署 | **仅 Ubuntu 一键部署** |

源仓 `crypto_monitor` **只读复制**，不回改源仓。

## Ubuntu 一键部署（推荐）

服务器 **root** 执行：

```bash
curl -fsSL https://git.bz121.com/dekun/CoinOX/raw/branch/main/deploy/manage.sh | bash
```

交互菜单：部署 / 卸载 / 更新 / 仅检测。  
安装到 `/opt/coinox`，PM2 进程 `coinox`，默认端口 `5010`，**默认模拟盘**。

详情见 [部署文档.md](./部署文档.md) 与 [deploy/README.md](./deploy/README.md)。

已安装后管理：

```bash
bash /opt/coinox/deploy/manage.sh
```

## 本机开发（Ubuntu）

```bash
cd /opt/coinox   # 或你的克隆目录
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp -n .env.example .env
python app.py
```

## 环境要点

- `SIM_DEFAULT_MODE=sim`（默认模拟盘）
- `OKX_OPTIONS_MARGIN_MODE=coin`（固定）
- `OKX_TRADE_MODE=perp_options|options_options`（本仓仅对冲）
- `HEDGE_PO_MODE=eth|btc|btc_eth`（一实例一模式一子账户；跨币见 `HEDGE_CROSS_NOTIONAL_K`）
- `STANDALONE_OPTIONS_UI=false`（默认；勿开，除非临时救急）
- `SIM_INITIAL_EQUITY_USDT=10000`
- `APP_PORT=5010`

永期三模式说明与审计清单见 [docs/永期对冲三模式.md](docs/永期对冲三模式.md)。

## 风险

实盘风险自负。默认模拟盘；切 `live` 前请核对 API 权限与资金。