From a23fb7cbdc0f9f9c39a4946663b5f23d985f1ea7 Mon Sep 17 00:00:00 2001 From: dekun Date: Wed, 7 Oct 2026 15:29:30 +0800 Subject: [PATCH] =?UTF-8?q?=E5=90=8C=E6=AD=A5=E5=AE=9E=E7=9B=98=E8=AF=B4?= =?UTF-8?q?=E6=98=8E=E6=96=87=E6=A1=A3=E3=80=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Cursor --- docs/实盘说明.md | 168 +++++++++++++++++++++++------------------------ 1 file changed, 84 insertions(+), 84 deletions(-) diff --git a/docs/实盘说明.md b/docs/实盘说明.md index 39d4efa..3482db5 100644 --- a/docs/实盘说明.md +++ b/docs/实盘说明.md @@ -1,84 +1,84 @@ -# 交易所实盘说明（OKX） - -本页说明如何把本实例从模拟盘切到真实交易：API 权限、OKX 账户模式、以及实例 `.env` 关键项。币本位期权开仓会先用 USDT 买 ETH/BTC，再开期权，因此 **现货交易权限** 与 **合约模式** 缺一不可。 - -## 一、创建 OKX API Key - -1. 登录 OKX → **个人中心 → API** → 创建 API Key。 -2. 权限务必勾选 **交易（Trade）**。币本位开仓会走现货买币，只开合约/期权权限不够。 -3. 若有细分权限，请同时打开 **现货（Spot）**。 -4. 建议开启 **IP 白名单**，填入本实例服务器出口 IP。 -5. 保存后得到：`API Key` / `Secret Key` / `Passphrase`，填入本实例 env（见下文）。 - -常见报错： - -| 现象 | 原因 | 处理 | -| --- | --- | --- | -| `50123` This API Key does not have trading permission for the Crypto | Key 无现货/交易权限 | 编辑 Key，勾选交易与现货后重试 | -| `未授权` / Bridge 探测失败 | 中控 Token 或客户端未部署接口 | 核对实例 Bridge Token；客户端需已部署 `/api/hub/version` | - -## 二、OKX 账户模式 - -交易页 → **账户模式**（首次切换须在网页/App 手动确认）。 - -| 账户模式 | 是否推荐 | 说明 | -| --- | --- | --- | -| 仅现货 / 简单模式 | 否 | 无法正常开期权 | -| **合约模式（现货和合约）** | **推荐** | 现货用 `cash`，与当前程序一致 | -| 跨币种保证金 | 可用但不推荐 | 现货须 `cross`，程序目前按合约模式写 `cash`，会报 `tdMode` 错 | -| 组合保证金 | 可用但不推荐 | 同上，现货也须 `cross` | - -推荐流程：先切到 **合约模式** → 再在本实例点「买币并开仓」。 - -相关报错： - -| 现象 | 原因 | 处理 | -| --- | --- | --- | -| You can't complete this request under your current account mode (`51010`) | 账户模式不支持本次下单 | 改为合约模式 | -| Parameter tdMode error | 跨币种/组合下仍用 `cash` 下现货 | 改回合约模式，或等待程序支持按模式自动选 `tdMode` | - -## 三、实例 env 配置 - -在顶栏 **env配置**（或改服务器 `.env` 后重启）中设置： - -### 1. 实盘开关与密钥 - -- `LIVE_TRADING_ENABLED=true`：允许实盘下单。 -- `OKX_API_KEY` / `OKX_API_SECRET` / `OKX_API_PASSPHRASE`：上一步创建的密钥（期权与永续共用，不必单独配期权 Key）。 -- `SIM_DEFAULT_MODE=live`：运行模式切到实盘（顶栏显示 `okx_live`）。也可在运行时由系统把 `trading.mode` 写成 `live`。 - -切到实盘后： - -- 顶栏「交易账户 / 总资金」只显示交易所真实余额；未充值时应为 `—` 或 `0`，不会再残留模拟盘数字。 -- 模拟钱包余额不会带到实盘。 - -### 2. 期权相关（币本位） - -- `OKX_OPTIONS_ENABLED=true`：启用期权模块。 -- `OKX_OPTIONS_MARGIN_MODE=coin`：币本位（用 ETH/BTC 付权利金）。 -- `OKX_OPTIONS_MAX_ACTIVE_POSITIONS`：期权持仓上限（笔）；`0`=不限制；`1`=同时最多 1 个合约（同合约加仓不占新笔数）。 -- `OKX_OPTIONS_SPOT_BUY_BUFFER`：现货买入相对权利金的缓冲倍数（如 `1.05`）。 -- 目标平仓门控：`OKX_OPTIONS_CLOSE_GATE_MODE`、`OKX_OPTIONS_CLOSE_RECYCLE_MULT_COIN`、`OKX_OPTIONS_CLOSE_HOLD_SECONDS` 等（见 env 页「期权账户」分组）。 - -保存后按提示 **保存并重启**（或 PM2 重启），再刷新页面确认顶栏为 `okx_live`。 - -## 四、开仓前自检清单 - -1. OKX 账户模式 = **合约模式**。 -2. API Key 有 **交易 + 现货**，IP 白名单正确。 -3. `.env`：`LIVE_TRADING_ENABLED=true`，密钥已填，模式为 `live`。 -4. 交易账户有足够 **USDT**（买币）以及开期权所需的标的币/保证金。 -5. 期权持仓上限、全仓复利等规则符合预期。 - -## 五、翻倍离场与指数离场（实盘同样生效） - -后台监控轮询实盘持仓，达标后按买一限价平仓： - -- **翻倍离场**：买一可回收 ≥ 开仓权利金 × (1 + 倍数) 时平仓。 -- **指数离场**：标的指数到位后触发，但仍须通过「目标平仓门控」（权利金倍数持续若干秒等）。 - -开仓时勾选/填写对应出场条件，并保证实例进程在跑。 - -## 六、中控远程更新注意 - -中控「系统更新 → 客户端远程更新」依赖实例的 `/api/hub/version` 与 `/api/hub/update`。若版本列报「非 JSON / 404」，请先在该实例服务器手动 `git pull` 并重启一次，再在中控刷新版本。 +# 交易所实盘说明（OKX） + +本页说明如何把本实例从模拟盘切到真实交易：API 权限、OKX 账户模式、以及实例 `.env` 关键项。币本位期权开仓会先用 USDT 买 ETH/BTC，再开期权，因此 **现货交易权限** 与 **合约模式** 缺一不可。 + +## 一、创建 OKX API Key + +1. 登录 OKX → **个人中心 → API** → 创建 API Key。 +2. 权限务必勾选 **交易（Trade）**。币本位开仓会走现货买币，只开合约/期权权限不够。 +3. 若有细分权限，请同时打开 **现货（Spot）**。 +4. 建议开启 **IP 白名单**，填入本实例服务器出口 IP。 +5. 保存后得到：`API Key` / `Secret Key` / `Passphrase`，填入本实例 env（见下文）。 + +常见报错： + +| 现象 | 原因 | 处理 | +| --- | --- | --- | +| `50123` This API Key does not have trading permission for the Crypto | Key 无现货/交易权限 | 编辑 Key，勾选交易与现货后重试 | +| `未授权` / Bridge 探测失败 | 中控 Token 或客户端未部署接口 | 核对实例 Bridge Token；客户端需已部署 `/api/hub/version` | + +## 二、OKX 账户模式 + +交易页 → **账户模式**（首次切换须在网页/App 手动确认）。 + +| 账户模式 | 是否推荐 | 说明 | +| --- | --- | --- | +| 仅现货 / 简单模式 | 否 | 无法正常开期权 | +| **合约模式（现货和合约）** | **推荐** | 现货用 `cash`，与当前程序一致 | +| 跨币种保证金 | 可用但不推荐 | 现货须 `cross`，程序目前按合约模式写 `cash`，会报 `tdMode` 错 | +| 组合保证金 | 可用但不推荐 | 同上，现货也须 `cross` | + +推荐流程：先切到 **合约模式** → 再在本实例点「买币并开仓」。 + +相关报错： + +| 现象 | 原因 | 处理 | +| --- | --- | --- | +| You can't complete this request under your current account mode (`51010`) | 账户模式不支持本次下单 | 改为合约模式 | +| Parameter tdMode error | 跨币种/组合下仍用 `cash` 下现货 | 改回合约模式，或等待程序支持按模式自动选 `tdMode` | + +## 三、实例 env 配置 + +在顶栏 **env配置**（或改服务器 `.env` 后重启）中设置： + +### 1. 实盘开关与密钥 + +- `LIVE_TRADING_ENABLED=true`：允许实盘下单。 +- `OKX_API_KEY` / `OKX_API_SECRET` / `OKX_API_PASSPHRASE`：上一步创建的密钥（期权与永续共用，不必单独配期权 Key）。 +- `SIM_DEFAULT_MODE=live`：运行模式切到实盘（顶栏显示 `okx_live`）。也可在运行时由系统把 `trading.mode` 写成 `live`。 + +切到实盘后： + +- 顶栏「交易账户 / 总资金」只显示交易所真实余额；未充值时应为 `—` 或 `0`，不会再残留模拟盘数字。 +- 模拟钱包余额不会带到实盘。 + +### 2. 期权相关（币本位） + +- `OKX_OPTIONS_ENABLED=true`：启用期权模块。 +- `OKX_OPTIONS_MARGIN_MODE=coin`：币本位（用 ETH/BTC 付权利金）。 +- `OKX_OPTIONS_MAX_ACTIVE_POSITIONS`：期权持仓上限（笔）；`0`=不限制；`1`=同时最多 1 个合约（同合约加仓不占新笔数）。 +- `OKX_OPTIONS_SPOT_BUY_BUFFER`：现货买入相对权利金的缓冲倍数（如 `1.05`）。 +- 目标平仓门控：`OKX_OPTIONS_CLOSE_GATE_MODE`、`OKX_OPTIONS_CLOSE_RECYCLE_MULT_COIN`、`OKX_OPTIONS_CLOSE_HOLD_SECONDS` 等（见 env 页「期权账户」分组）。 + +保存后按提示 **保存并重启**（或 PM2 重启），再刷新页面确认顶栏为 `okx_live`。 + +## 四、开仓前自检清单 + +1. OKX 账户模式 = **合约模式**。 +2. API Key 有 **交易 + 现货**，IP 白名单正确。 +3. `.env`：`LIVE_TRADING_ENABLED=true`，密钥已填，模式为 `live`。 +4. 交易账户有足够 **USDT**（买币）以及开期权所需的标的币/保证金。 +5. 期权持仓上限、全仓复利等规则符合预期。 + +## 五、翻倍离场与指数离场（实盘同样生效） + +后台监控轮询实盘持仓，达标后按买一限价平仓： + +- **翻倍离场**：买一可回收 ≥ 开仓权利金 × (1 + 倍数) 时平仓。 +- **指数离场**：标的指数到位后触发，但仍须通过「目标平仓门控」（权利金倍数持续若干秒等）。 + +开仓时勾选/填写对应出场条件，并保证实例进程在跑。 + +## 六、中控远程更新注意 + +中控「系统更新 → 客户端远程更新」依赖实例的 `/api/hub/version` 与 `/api/hub/update`。若版本列报「非 JSON / 404」，请先在该实例服务器手动 `git pull` 并重启一次，再在中控刷新版本。