模拟盘需求文档 v1.0

状态：需求讨论中 | 目标：2026-02-28 晚上线 | 负责人：露露

一、产品定位

V5.1信号引擎的模拟交易系统。信号触发后自动虚拟开仓，实时追踪持仓盈亏，按规则自动平仓（TP/SL/超时），积累真实市场环境下的交易数据用于策略优化。

核心目标：验证策略在真实市场中的表现，为实盘上线提供数据支撑。

二、支持币种

BTC / ETH / XRP / SOL（4个）

三、页面结构

侧边栏入口

• 名称：模拟盘
• 位置：在"信号引擎 V5.1"下方

页面布局（从上到下）

3.1 总览面板（顶部卡片组）

3.2 当前持仓（实时更新）

每个活跃仓位显示：

3.3 K线图 + 交易标注（TradingView）

技术方案：使用 TradingView Lightweight Charts 渲染K线，数据源为币安合约API。

功能：

• 币种切换：BTC / ETH / XRP / SOL
• 时间周期：1m / 5m / 15m / 1h
• K线数据：从币安 /fapi/v1/klines 实时获取
• 交易标注（核心功能）：
  • 🟢 绿色向上箭头 = 做多开仓
  • 🔴 红色向下箭头 = 做空开仓
  • ⬜ 白色/灰色标记 = 平仓点
  • 虚线水平线 = TP1/TP2/SL价位（当前持仓时显示）
• 鼠标悬停标注可查看详情（评分、盈亏等）

3.4 历史交易列表

表格字段：

筛选功能：

• 按币种：全部 / BTC / ETH / XRP / SOL
• 按结果：全部 / 盈利 / 亏损

3.5 权益曲线图

• X轴：时间
• Y轴：累计PnL(R)
• 折线图，绿色区域填充（正收益）/ 红色（负收益）
• 可直观看到资金曲线走势和回撤

3.6 统计面板

四、后端逻辑

4.1 数据表：paper_trades

CREATE TABLE paper_trades (
    id SERIAL PRIMARY KEY,
    symbol VARCHAR(20) NOT NULL,          -- BTCUSDT/ETHUSDT/...
    direction VARCHAR(10) NOT NULL,       -- LONG/SHORT
    score INT NOT NULL,                   -- 开仓时V5.1评分
    tier VARCHAR(20) NOT NULL,            -- light/standard/heavy
    entry_price DOUBLE PRECISION NOT NULL,
    entry_ts BIGINT NOT NULL,             -- 开仓时间戳(ms)
    exit_price DOUBLE PRECISION,
    exit_ts BIGINT,                       -- 平仓时间戳(ms)
    tp1_price DOUBLE PRECISION NOT NULL,
    tp2_price DOUBLE PRECISION NOT NULL,
    sl_price DOUBLE PRECISION NOT NULL,
    tp1_hit BOOLEAN DEFAULT FALSE,
    status VARCHAR(20) DEFAULT 'active',  -- active/tp1_hit/tp/sl/sl_be/timeout
    pnl_r DOUBLE PRECISION DEFAULT 0,
    created_at TIMESTAMP DEFAULT NOW()
);

4.2 交易逻辑（集成到 signal_engine.py）

开仓条件：

• V5.1评分 ≥ 60分（有信号时）
• 该币种无活跃持仓
• 冷却期已过（10分钟）

开仓动作：

• 记录入场价（当前价格）
• 计算TP1/TP2/SL：
  • LONG: SL = price - 2×ATR, TP1 = price + 1.5×ATR, TP2 = price + 3×ATR
  • SHORT: SL = price + 2×ATR, TP1 = price - 1.5×ATR, TP2 = price - 3×ATR
• 写入 paper_trades 表

持仓监控（每15秒检查一次）：

• 用实时价格检查TP1/TP2/SL
• TP1触发 → 标记tp1_hit，移动SL到成本价
• TP2触发 → 平仓，PnL = 0.5×1.5R + 0.5×3.0R = 2.25R
• SL触发 → 平仓，PnL = -1R（或保本如果tp1已触发）
• 超时(60分钟) → 按当前价平仓

4.3 API接口

五、Discord推送（可选）

每次开仓/平仓时推送消息到Discord：

开仓通知：

🟢 模拟开多 BTCUSDT
入场价: $63,523.8 | 评分: 87 | 档位: 加仓
TP1: $63,850 | TP2: $64,200 | SL: $63,100

平仓通知：

✅ 模拟平仓 BTCUSDT (做多)
入场: $63,523.8 → 出场: $63,850.0
盈亏: +2.25R | 状态: 止盈(TP)
持仓: 8.5分钟 | 累计: +45.3R

六、开发计划

目标：2026-02-28 晚上线运行