Files

T

2026-05-21 11:45:49 +08:00

7.1 KiB

Raw Blame History

使用说明

本文件对应仓库：crypto_monitor_binance（Binance U 本位永续）。
功能、界面与 Gate.io USDT 永续版（目录 crypto_monitor_gate）基本一致，差异主要在 .env 里交易所密钥与部分参数名（BINANCE_* / GATE_*），文末有对照。

部署、代理、PM2 等请参考本仓库说明或 crypto_monitor_gate 下的 部署文档.md（该文以 Gate + SSH SOCKS 为例；Binance 侧将 API 与密钥改为 BINANCE_* 即可类比）。
关键位自动开仓的规则、RR、结案原因见本目录 关键位自动下单说明.md。

1. 它能做什么

面向个人盘面的 Web 控制台，主要能力包括：

模块	说明
关键位监控	录入上/下沿与类型，按 5m 收线做硬条件过滤；符合条件后企业微信提醒，部分类型可自动市价开仓（见第 4 节与专门文档）。
实盘下单监控	手工填止损/止盈，以损定仓市价开单，挂上条件止盈止损，并在页面跟踪浮盈亏、保本逻辑等。
交易记录 / 复盘	平仓结果、盈亏、错过的单等归档与导出。

后台按 MONITOR_POLL_SECONDS（默认几秒）轮询行情与监控逻辑。切勿在未理解规则时同时运行两套程序共用一个实盘账户。

2. 运行前必须配置（`.env`）

首次在本目录执行 cp .env.example .env，再编辑 .env（.env 勿提交 Git；git pull 不会改你的 .env，升级前建议 cp .env .env.backup.$(date +%Y%m%d)）。

至少检查以下项（具体键名以 .env.example 为准）：

类别	说明
登录网页	`APP_PASSWORD`：打开站点后的登录口令。`FLASK_SECRET_KEY`：Session 密钥，请勿使用默认值。
企业微信	`WECHAT_WEBHOOK`：告警与关键位推送机器人的 Webhook。
是否真下单	`LIVE_TRADING_ENABLED=false`：不会向交易所发送开仓指令（适合测试流程）。改为 `true` 且密钥正确才会实盘。
交易所 API	本仓库： `BINANCE_API_KEY`、`BINANCE_API_SECRET`；永续相关见 `BINANCE_MARGIN_MODE`、`BINANCE_POSITION_MODE`、`BINANCE_TRIGGER_WORKING_TYPE` 等。勿把 `.env` 提交到 Git。
关键位 RR / 止损外扩	`KEY_AUTO_MIN_PLANNED_RR`、`KEY_STOP_OUTSIDE_BREAKOUT_PCT`（详见 `关键位自动下单说明.md`）。

网络需要代理时可配置 BINANCE_SOCKS_PROXY / BINANCE_HTTP_PROXY（与 Gate 版 GATE_*_PROXY 用法类似）。

3. 如何启动与登录

准备 Python 虚拟环境并安装依赖（如 flask、requests、ccxt、按需 Pillow、PySocks 等），配置好 .env。
启动 Flask 应用（可用 ecosystem.config.cjs 交给 PM2，或本地 python app.py / flask run，以你当前脚本为准）。
浏览器访问站点，打开 /login，使用 .env 里的 APP_PASSWORD 登录。

登录后顶栏为四页：关键位监控 | 实盘下单（默认首页）| 交易记录与复盘 | 统计分析。

4. 关键位监控（顶栏「关键位监控」→ `/key_monitor`）

4.1 添加一条关键位

币种：如 BTC 或 BTC/USDT（会规范成内部符号）。

类型（必选其一）：

类型	行为摘要
箱体突破	通过门控且计划 RR 达标 → 自动市价开仓（需 `LIVE_TRADING_ENABLED=true` 且无其他持仓占位）。结案后本条从列表消失并记入历史。
收敛突破	同上（自动开仓类）。
关键阻力位	不自动开仓；触发后发 1 次微信，然后本条结案进历史。
关键支撑位	同上（仅提醒）。

方向：做多 / 做空（必选）。
上沿 / 下沿：必填；保存时会按交易所 价格精度 取整。

限制：
活跃持仓数达到 MAX_ACTIVE_POSITIONS（默认 1）时，不允许再添加「箱体突破 / 收敛突破」；仍可添加「关键阻力位 / 支撑位」。
若 4h EMA55 与你的方向逆势，页面会 额外 Flash 提示，不阻挡提交。

4.2 触发后会发生什么（简版）

箱体 / 收敛：门控通过后算计划 SL/TP 与 RR；不达标 → 微信说明 + rr_insufficient 结案；达标 → 市价开仓，成功 auto_opened / 失败 exchange_failed，均不重试同一关键位。
阻力 / 支撑：仅 单次推送 → key_level_alert_only 结案。

详细公式与字段见 关键位自动下单说明.md。

4.3 列表与历史

当前条目与历史记录的用法与 Gate 版相同；结案后可在历史区查阅 close_reason。

5. 实盘下单（顶栏「实盘下单」→ `/trade`）

持仓上限由 MAX_ACTIVE_POSITIONS 控制（默认 1）。
人工开仓计划盈亏比不得低于 MANUAL_MIN_PLANNED_RR（默认 1.4:1）。
填写币种、方向、杠杆（可选）、止损/止盈（价格或百分比按表单）。
移动保本等选项按页面与 .env 默认。

开仓成功后卡片 「来源」：手工一般为 下单监控；关键位自动为 关键位监控。

6. 企业微信

推送逻辑与 Gate 版一致；未配置 WECHAT_WEBHOOK 时可能没有消息，请以 交易所端 核对持仓与挂单。

7. 强烈建议的风险与运维习惯

先用 LIVE_TRADING_ENABLED=false 熟悉流程再实盘。
API 权限最小化，密钥勿泄露。
同一账户避免多程序重复开仓。
自动备份：服务器上执行 bash scripts/install_backup_cron.sh（每天北京时间 0:00 → /root/backups，保留 30 天）；升级前也可 bash scripts/backup_data.sh 手动跑一次。
升级代码后留意 首轮启动有无数据库迁移报错。

8. 常见问题（简要）

现象	可自查
关键位永远不触发	门控五项、日成交量排名、`KLINE_TIMEFRAME`。
有信号但不自动开仓	`LIVE_TRADING_ENABLED`、RR 阈值、是否已有持仓、API/保证金错误信息。
加不了箱体/收敛	是否已有持仓。
推送收不到	Webhook、网络。

9. Gate 版（`crypto_monitor_gate`）差异速查

项目	Binance 本仓库	Gate 版
API 变量	`BINANCE_API_KEY`、`BINANCE_API_SECRET`、`BINANCE_*`	`GATE_API_KEY`、`GATE_API_SECRET`、`GATE_*`
代理示例	`BINANCE_SOCKS_PROXY`	`GATE_SOCKS_PROXY`
TP/SL 实现	`_binance_place_tp_sl_orders`	`_gate_place_tp_sl_orders`、`GATE_TPSL_*`
资金舍入口径	`FUNDS_DECIMALS`（与记账一致）	以 Gate 仓库实现为准

业务流程（登录、四种关键位、手工单、单仓）两份程序对齐；仅需更换目录与 .env。

7.1 KiB Raw Blame History Unescape Escape