Files

T

dekun d4eb6832b7 Rewrite usage guide for current options and hedge flows.

Remove obsolete strategy, key auto-order, and AI review sections.

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

2026-08-13 20:06:23 +08:00

7.4 KiB

Raw Permalink Blame History

使用说明

仓库: https://git.bz121.com/dekun/crypto_okx.git

基于 Flask 的 OKX 期权 / 对冲 Web 控制台.与中控、其它交易所实例无关.

部署 / PM2 / SOCKS 见 部署文档.md:

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

默认访问: http://<服务器IP>:5004 → 首页跳转期权 /options.

1. 能做什么

模块	路由	说明
期权	`/options`	看期权链、开平仓、持仓监控(翻倍出场等)
期权复盘	`/options/review`	期权成交记录 → 复盘表单 → 复盘列表与统计
对冲计划	`/hedge-plan`	永期对冲或期期对冲:测算、启动、进行中/历史/统计
模拟资金	系统设置 → 模拟资金	本地钱包撮合,吃公开买卖一,不下真实交易所单
env 配置	`/env_config`	浏览器改 `.env`(API、交易模式、预算等)
系统设置	`/settings`	导航显示、模拟/实盘、密码、划转、导出等

顶栏还可按需显示:关键位监控(提醒)、数据看板、账户流水、风控说明等(在 系统设置 → 导航显示 开关).

已移除: 策略交易、关键位自动下单、永续实盘下单页、永续交易记录/复盘、AI 复盘、中控对接.

2. 登录与顶栏

打开站点 → 登录(APP_USERNAME / APP_PASSWORD,见 .env).
顶栏标题区显示交易所名;若为模拟模式会标模拟.
资金条含:总资金、资金/交易账户(USDT)、期权资金/交易账户(USDC)、实时盈亏等(模拟/实盘数据源不同).

3. 交易模式(必读)

在 env 配置 或 .env 中设置 OKX_TRADE_MODE(多数可热更,启用类开关改后建议重启):

值	含义
`options`	单独期权:可单独开期权;隐藏对冲导航
`perp_options`	永期对冲:不可单独开期权;对冲页显示「永期对冲」
`options_options`	期期对冲:不可单独开期权;对冲页显示「期期对冲」

对冲模式下期权页仍可查看/平仓已有仓,但不能单独新开期权.

对冲与单独期权默认可互斥(HEDGE_PLAN_OPTIONS_MUTUAL_EXCLUSIVE=true):有对冲计划时不可单独开期权,有单独期权时不可启动对冲.

4. 期权页(`/options`)

4.1 前置

OKX_OPTIONS_ENABLED=true(默认 true)
已配置 OKX_API_KEY / OKX_API_SECRET / OKX_API_PASSPHRASE(永续与期权共用)
实盘真下单需 LIVE_TRADING_ENABLED=true;否则多为本地流程/模拟(见第 7 节)
期权账户为 USDC;永续腿为 USDT,资金不互通

4.2 开仓流程

选标的 ETH / BTC、到期日.
列表或 T 型 看链;可筛看涨/看跌、实值/虚值;勾选「展开全部」看全部行权价.
环境「链上仅显示有卖一」开启时,无真实卖一或深度不足 1 张的合约会隐藏.
点某行买入 → 下单面板确认张数、权利金、到期平衡等.
张数:「按可用余额打满」受单笔预算 OKX_OPTIONS_TRADE_BUDGET_USDC × 缓冲 OKX_OPTIONS_BUDGET_BUFFER 限制;「全仓复利」用交易户全部可用(可设全仓上限),且通常仅允许同时 1 笔持仓.
可勾选 翻倍出场(盈利达权利金倍数后限价平).

4.3 持仓与平仓

右侧/下方持仓卡可改翻倍倍数或关闭、执行平仓.
平仓默认买一限价;是否允许市价平见 OKX_OPTIONS_ALLOW_MARKET_CLOSE.
页面内「开仓规则说明」与 /options/guide 有更细规则.

5. 期权复盘(`/options/review`)

交易记录:筛选期权成交/平仓记录.
复盘表单:选中一笔填写复盘内容并保存.
复盘记录 / 统计:查看已复盘条目与汇总.

该页只覆盖期权侧,不含已移除的永续交易日记账.

6. 对冲计划(`/hedge-plan`)

需将 OKX_TRADE_MODE 设为 perp_options 或 options_options.

6.1 页签

Tab	说明
永期对冲	期权腿 + 永续腿(仅 `perp_options`)
期期对冲	双期权腿(仅 `options_options`)
进行中的计划	盯盘 / 开仓中 / 半腿 / 持仓中
历史记录	已结束计划
统计分析	对冲结果汇总

6.2 永期对冲要点

账户:永续 → 合约账户(USDT);期权 → 期权账户(USDC).
以期权为主(HEDGE_PLAN_OPTION_PRIMARY=true):填参后「策略启动」进入盯盘,条件达标后自动先开期权再市价永续.
保险模式(HEDGE_PLAN_OPTION_PRIMARY=false):做多配 Put、做空配 Call;现场按开仓价与止盈止损执行,交易所 TP/SL 出场.
组数上限:MAX_ACTIVE_HEDGE_PLANS(默认 1).

6.3 期期对冲要点

按预算或张数拆分主/次腿(见 HEDGE_PLAN_OO_BIAS_*).
平仓模式(到期平 / 全平等)受 HEDGE_PLAN_OO_CLOSE_MODE_ENABLED 控制.

6.4 半腿

一侧成交、另一侧失败时,默认可挂 partial 在页面 手动补开(HEDGE_PLAN_MANUAL_COMPLETE_ON_PARTIAL=true),避免误自动平掉已成腿.

真下单还需 HEDGE_PLAN_LIVE_ORDER=true 与 LIVE_TRADING_ENABLED=true(以 env 为准).

7. 模拟资金 vs 实盘

系统设置 → 模拟资金:

操作	说明
切换到模拟资金	本地 SQLite 钱包;用 OKX 公开行情吃买卖一结算,不向交易所下真实单
切换到实盘	走真实 API(须密钥正确且允许实盘)
重置权益	无仓时可重置;强制重置会清仓
划转 / USDT↔USDC	仅作用于模拟钱包

启动默认模式:SIM_DEFAULT_MODE=sim 或 live.顶栏出现模拟徽章即表示当前为模拟.

8. 系统设置与 env

系统设置(`/settings`)

导航显示:开关顶栏各入口
模拟资金:见上节
账户密码:改登录口令
永续划转 / 期权划转 / 币种兑换:实盘账户内资金操作(模拟模式有对应模拟划转)
数据导出:导出相关 CSV

env 配置(`/env_config`)

常用项:

类别	变量示例
登录	`APP_PASSWORD`,`FLASK_SECRET_KEY`
API	`OKX_API_*`,`OKX_TD_MODE`,`OKX_POS_MODE`
代理	`OKX_SOCKS_PROXY=socks5h://127.0.0.1:1080`
实盘开关	`LIVE_TRADING_ENABLED`
模式	`OKX_TRADE_MODE`
期权预算	`OKX_OPTIONS_TRADE_BUDGET_USDC`,`OKX_OPTIONS_COMPOUND_FULL_*`
对冲	`HEDGE_PLAN_*`,`MAX_ACTIVE_HEDGE_PLANS`
企业微信	`WECHAT_WEBHOOK`

完整注释见根目录 .env.example..env 勿提交 Git;git pull 不会覆盖本地 .env.

9. 首次上手建议

部署并打开站点,登录后到 系统设置 → 模拟资金,确认处于模拟.
env 配置 填 API(模拟下单可不真下交易所,但拉链/行情通常仍需可达 OKX;本机受限时配 SOCKS).
设 OKX_TRADE_MODE=options,在期权页熟悉开平仓与持仓卡.
需要复盘时用 期权复盘.
再按需改成永期/期期对冲,先模拟跑通再切实盘.
实盘前再开 LIVE_TRADING_ENABLED / HEDGE_PLAN_LIVE_ORDER,并确认 OKX 权限、持仓模式、IP 白名单.

10. 风险与合规

期权与永续杠杆风险高,实盘盈亏自负.
勿把 .env、API 密钥提交到仓库或发到公网.
请遵守当地法规与 OKX 用户协议;本说明仅描述产品用法,不构成投资建议.

7.4 KiB Raw Permalink Blame History Unescape Escape