Files
crypto_monitor/crypto_monitor_okx/更新文档.md
T
2026-05-19 15:10:43 +08:00

80 lines
4.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 界面与风控更新说明(OKX 实例)
与 Gate / Binance 主站对齐的列表窗、统计分品类、交易记录展示、复盘与移动保本交易所同步;OKX 仍为 **三页导航**(交易执行 / 记录复盘 / 统计),关键位监控合并在 **交易执行** 页,**无** Gate 独立「关键位监控」页与斐波限价监控。
## 顶栏导航(3 项)
| 顺序 | 名称 | 路由 | 说明 |
|------|------|------|------|
| 1 | 交易执行 | `/trade` | 关键位监控 + 实盘下单(**默认首页** `/``/trade` |
| 2 | 交易记录与复盘 | `/records` | 交易记录、复盘表单、AI 历史(受顶栏 UTC 时间窗筛选) |
| 3 | 统计分析 | `/stats` | 按北京时间交易日切日 + 分品类统计块 |
## 列表时间窗(UTC,全站顶栏)
共用模块:仓库根目录 `history_window_lib.py`(与 Gate / Binance 一致)。
| 项 | 说明 |
|----|------|
| 默认 | **UTC 当日**`win_preset=utc_today` |
| 可选 | 近 24 小时、近 7 天、自定义起止(UTC) |
| 作用范围 | 关键位历史、交易记录列表、复盘 API、AI 历史 API、导出「交易记录」「关键位历史」 |
| 与统计 | **仅影响列表/导出**;统计页仍按北京时间 `TRADING_DAY_RESET_HOUR`(默认 8:00)切日 |
| 切换 | 顶栏「列表筛选(UTC)」→ 应用(保留当前路由 query) |
## 交易记录与复盘
- 列表 **止损(开仓)**:展示 `initial_stop_loss` 快照(`display_open_stop_loss`)。
- 类型列显示 `monitor_type``key_signal_type`(若有)。
- 平仓入库:`stop_loss` / `initial_stop_loss` 为开仓止损快照;机器单 `entry_reason` 可按 `key_signal_type` 自动映射(箱体突破 / 收敛突破 → 四条固定关键位开仓类型文案)。
- 复盘:开仓类型下拉含四条关键位固定文案 +「其他」;离场触发含 **「止盈」**;从交易记录填入时按结果与信号预填。
- 复盘 K 线图:以 **平仓时间** 为锚点向前约 `ORDER_CHART_LIMIT`(默认 100)根(`_fetch_ohlcv_ending_at`)。
- `/api/journals``/api/reviews` 与顶栏 UTC 窗一致。
### 导出(交易记录 v3
- 文件名:`trade_records_v3_YYYYMMDD.csv`
-`key_signal_type``initial_stop_loss`、计划/实际 RR、`risk_amount` 等;末列「开仓类型」为有效展示文案。
- 受 UTC 列表窗限制;关键位历史导出同理。
## 实盘下单(交易执行页)
- **移动保本**:表单可勾选「启用移动保本」;触发阶梯上移后 **先撤后挂** 交易所 TP/SL`replace_active_monitor_tpsl_on_exchange`),仅成功后才写库;企业微信提示含「交易所:已先撤后挂止盈止损」。未配置实盘 API 时仅更新本地止损。
- 开仓 TP/SL 仍通过 OKX `attachAlgoOrds`(与原有逻辑一致);重挂使用 ccxt `stopLoss` / `takeProfit` 参数,触发价经 `_okx_algo_trigger_price_str` 格式化。
## 统计分析页(`/stats`
| 项 | 说明 |
|----|------|
| 切日 | 北京时间;边界 = `TRADING_DAY_RESET_HOUR:00`(默认 8 |
| 品类下拉 | 全部交易、下单监控、关键位箱体突破、关键位收敛结构、关键位斐波0.618、关键位斐波0.786 |
| URL | `stats_segment=``all` / `manual` / `key_box` / `key_conv` / `key_fib618` / `key_fib786` |
| 与 UTC 窗 | 统计 **不** 随顶栏列表窗变化 |
## 斐波关键位监控(与 Gate / Binance 对齐)
| 项 | 说明 |
|----|------|
| 类型 | **斐波回调0.618**、**斐波回调0.786**(交易执行页关键位表单) |
| 同币互斥 | 每币仅一条斐波监控 |
| 挂单价 E | 做多 `E = H ratio×(HL)`;做空 `E = L + ratio×(HL)`SL/TP 为 L/H |
| 添加后 | 立即在 OKX 挂限价单;卡片显示 **挂E**、限价单 ID |
| 失效 | 标记价触达止盈侧且限价未成交 → 仅撤本条限价单(`cancel_fib_limit_order` |
| 成交后 | 挂交易所 TP/SL → 写入 `order_monitors``monitor_type=关键位监控``key_signal_type=斐波回调…`)→ 从关键位表移除 |
| 轮询 | `check_fib_key_monitors()`(与箱体/收敛 `check_key_monitors()` 分离) |
| 盈亏比 | 计划 RR 须 > `KEY_AUTO_MIN_PLANNED_RR`(默认 1.5 |
| 日成交量 | 排名前 `KEY_DAILY_VOLUME_RANK_MAX`(默认 30 |
计算逻辑见仓库根目录 `fib_key_monitor_lib.py`
## 与 Gate 的差异(其余)
- 无独立「关键位监控」导航页(斐波在 **交易执行** 页添加)。
- 无交易所已实现盈亏同步(`/api/sync_exchange_pnl`)。
- 箱体/收敛仍为 **提醒** 模式,不自动市价开仓(Gate/Binance 主站为自动开仓)。
## 配置与部署
- 详见 `.env.example` 中 OKX`OKX_*`)与通用风控项。
- 代码更新后请 **重启 OKX 监控进程**;旧库行不做批量回填,展示字段有则用之、无则回退。