dekun
4.5 KiB
4.5 KiB
交易所实盘说明（OKX）
本页说明如何把本实例从模拟盘切到真实交易：API 权限、OKX 账户模式、以及实例 .env 关键项。币本位期权开仓会先用 USDT 买 ETH/BTC，再开期权，因此 现货交易权限 与 合约模式 缺一不可。
一、创建 OKX API Key
- 登录 OKX → 个人中心 → API → 创建 API Key。
- 权限务必勾选 交易（Trade）。币本位开仓会走现货买币，只开合约/期权权限不够。
- 若有细分权限，请同时打开 现货（Spot）。
- 建议开启 IP 白名单，填入本实例服务器出口 IP。
- 保存后得到：
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。
四、开仓前自检清单
- OKX 账户模式 = 合约模式。
- API Key 有 交易 + 现货，IP 白名单正确。
.env：LIVE_TRADING_ENABLED=true，密钥已填，模式为live。- 交易账户有足够 USDT（买币）以及开期权所需的标的币/保证金。
- 期权持仓上限、全仓复利等规则符合预期。
五、翻倍离场与指数离场（实盘同样生效）
后台监控轮询实盘持仓，达标后按买一限价平仓：
- 翻倍离场：买一可回收 ≥ 开仓权利金 × (1 + 倍数) 时平仓。
- 指数离场：标的指数到位后触发，但仍须通过「目标平仓门控」（权利金倍数持续若干秒等）。
开仓时勾选/填写对应出场条件，并保证实例进程在跑。
六、中控远程更新注意
中控「系统更新 → 客户端远程更新」依赖实例的 /api/hub/version 与 /api/hub/update。若版本列报「非 JSON / 404」，请先在该实例服务器手动 git pull 并重启一次，再在中控刷新版本。