SpreadCandles 价差K线指标 – 使用说明书

? 指标简介

SpreadCandles 是一款强大的价差K线生成与交易工具，可以帮助您：

• 生成任意秒级K线：将任何品种转换为秒级K线（如5秒、10秒、30秒等）
• 创建价差K线：生成两个品种的比例或差值K线，用于价差交易、套利策略等
• 一键配对交易 ⭐：内置交易按钮，一键完成双品种配对交易
• 实时更新：K线实时生成并更新，无延迟

? 为什么选择 SpreadCandles？

传统方式的痛点

• ❌ 需要在两个图表上分别下单
• ❌ 容易遗漏或下错方向
• ❌ 操作繁琐，时机难把握

SpreadCandles 的优势

• ✅ 一键完成：点击一个按钮，自动配对交易A和B
• ✅ 不会出错：系统自动判断方向，A买入必定配B卖出
• ✅ 实时价差：在价差K线上直接观察并交易
• ✅ 同步平仓：一键同时平掉两个品种

---

✨ 主要功能

1️⃣ 单品种秒级K线

将任何交易品种转换为自定义秒级周期的K线。

使用场景：

• 超短线交易，需要比1分钟更细的时间粒度
• 高频策略开发和回测
• 精确观察价格变化

2️⃣ 双品种价差K线

生成两个品种的价差或比例K线。

使用场景：

• 价差交易：BTCUSD vs ETHUSD 的价差套利
• 相关性分析：观察两个品种的相对强弱
• 对冲策略：监控对冲组合的价差变化

3️⃣ 一键交易功能 ⭐ 新增

在自定义品种图表上提供交易按钮，支持：

• 单品种交易：标准的开多/开空操作
• 价差配对交易：一键同时交易A和B品种
• 可调整手数：实时修改交易量
• 快速平仓：一键平仓或全平

---

? 快速开始

第一步：安装指标

1. MT5工具栏的”算法交易”按钮需要开启（开启后是绿色三角，未开启是红色方块）；
2. 将 SpreadCandles.ex5 文件复制到 MT5 的指标目录：

   从MT5界面，文件->打开数据文件夹->MQL5->Indicators

第二步：添加到图表

1. 在 MT5 的”导航器”窗口中找到 SpreadCandles(如果看不到，在导航窗口“指标”上点鼠标右键再点刷新)
2. 拖动到任意图表上
3. 在弹出的参数设置窗口中配置参数（见下文）
4. 点击”确定”

第三步：查看生成的K线

• 指标会自动创建一个新的自定义品种
• 自动打开该品种的图表窗口
• 新图表会显示生成的秒级或价差K线

第四步：使用交易功能 ⭐ 新增

如果启用了交易功能（默认启用），在自定义品种图表上会看到交易按钮：

1. 单品种模式（品种B为空）

• 点击”开多” → A品种买入
• 点击”开空” → A品种卖出
• 点击”平仓” → 平掉A品种持仓

1. 双品种模式（品种B有值）

• 点击”开多” → A买入 + B卖出（做多价差）
• 点击”开空” → A卖出 + B买入（做空价差）
• 点击”平仓” → 同时平掉A和B持仓

1. 调整手数

• 在”交易量”输入框中输入新的手数
• 点击任意交易按钮时自动应用

---

⚙️ 参数说明

基本参数

参数名称	说明	默认值	推荐设置
品种A	主品种名称（留空则使用当前图表品种）	空	BTCUSD
品种B	副品种名称（留空则为单品种模式）	ETHUSD	ETHUSD 或留空
UseRatio	计算方式：true=比例(A/B)，false=差值(A-B)	true	根据需求
K线周期(秒)	自定义K线的周期，单位：秒	10	5-60秒
UseMidPrice	使用中间价(Ask+Bid)/2，否则用Last价	true	true

高级参数

参数名称	说明	默认值	推荐设置
自定义品种后缀	生成品种的名称后缀	S	不用修改
自动打开图表	是否自动打开生成的品种图表	true	true
黑色背景	新图表使用黑色背景	true	根据喜好
清空历史数据	每次运行时清空旧数据	true	true
回填历史(分钟)	启动时回填多少分钟的历史K线	120	60-480
强制K线连续	强制开盘价=前收盘价（无跳空）	false	false
显示调试日志	显示详细的运行日志	false	调试时开启

交易功能参数 ⭐ 新增

参数名称	说明	默认值	推荐设置
启用交易功能	是否启用交易按钮	true	true
交易手数	默认开仓手数	1.0	根据资金设置
滑点	允许的最大滑点	3	3-10
订单注释	交易订单的注释文字	SpreadCandles	可自定义

---

? 使用场景详解

场景1️⃣：生成单品种秒级K线

目标： 将 BTCUSD 转换为 5 秒 K线

参数设置：

品种A: BTCUSD（或留空，在BTCUSD图表上运行）
品种B: （留空）
K线周期: 5
其他: 使用默认值

结果：

• 自动生成品种：BTCUSD.S5
• 显示 BTCUSD 的 5 秒 K线
• 实时更新

---

场景2️⃣：BTC/ETH 比例价差交易

目标： 观察 BTCUSD 和 ETHUSD 的比例关系

参数设置：

品种A: BTCUSD
品种B: ETHUSD
UseRatio: true（比例）
K线周期: 10
其他: 使用默认值

结果：

• 自动生成品种：BTCUSD_ETHUSD.S10
• 显示 BTC/ETH 比例的 10 秒 K线
• 比例上升 = BTC 相对强势
• 比例下降 = ETH 相对强势

交易策略示例：

• 当比例突破历史高点 → 可能做空BTC、做多ETH（均值回归）
• 当比例跌破历史低点 → 可能做多BTC、做空ETH

---

场景3️⃣：黄金白银价差套利

目标： 观察 XAUUSD 和 XAGUSD 的差值

参数设置：

品种A: XAUUSD
品种B: XAGUSD
UseRatio: false（差值）
K线周期: 30
其他: 使用默认值

结果：

• 自动生成品种：XAUUSD_XAGUSD.S30
• 显示金银价差的 30 秒 K线
• 价差扩大/收窄一目了然

---

? 查看生成的品种

方法1：自动打开

指标启动后会自动打开新品种的图表窗口。

方法2：手动打开

1. 在 MT5 中按 Ctrl+U 打开”交易品种”窗口
2. 在列表中找到生成的品种（如 BTCUSD_ETHUSD.S10）
3. 右键选择”图表窗口”

方法3：市场报价窗口

生成的品种会出现在”市场报价”窗口中，可以直接拖到图表上。

---

? 如何使用生成的K线

1. 技术分析

• 在生成的K线图表上添加任何技术指标（MA、MACD、RSI等）
• 画趋势线、支撑阻力位
• 使用图表形态进行分析

2. EA交易

• 生成的品种可以被EA读取
• 在EA中使用生成的品种名称（如 BTCUSD_ETHUSD.S10）
• EA可以读取OHLC、成交量等数据

3. 手工交易参考

• 在价差图表上观察信号
• 在原品种图表上执行交易
• 用价差K线辅助判断入场/出场时机

---

⚠️ 重要提示

✅ 正常现象

1. K线有跳空

• 对于价差K线，开盘价可能不等于前收盘价
• 这是正常现象，因为两个品种的报价时间不同步
• 如果想要无跳空，设置 强制K线连续 = true

1. 历史K线数量有限

• 受MT5服务器tick数据保存时间限制
• 通常可以回填几小时到几天的历史
• 建议 回填历史 = 60-120分钟

1. 成交量显示

• 单品种模式：显示品种A的成交量
• 双品种模式：显示两个品种成交量之和
• 成交量反映该时段内的tick更新次数

❌ 常见错误

1. “无法获取TICK数据”

• 原因：MT5服务器未保存足够的历史tick
• 解决：减少 回填历史 参数（如改为60分钟）

1. “品种B无效”

• 原因：品种名称输入错误或该品种不存在
• 解决：在”市场报价”中查看正确的品种名称

1. 图表不更新

• 原因：指标被移除或EA被停止
• 解决：重新添加指标到图表

---

?️ 优化建议

性能优化

1. K线周期选择

• 过小的周期（如1秒）会产生大量K线，占用资源
• 推荐：5-30秒

1. 历史回填长度

• 回填时间越长，启动越慢
• 推荐：60-120分钟（足够进行短期分析）

1. 清理无用品种

• 定期在”交易品种”窗口中删除不用的自定义品种
• 释放内存和存储空间

使用技巧

1. 保存模板

• 在生成的K线图表上设置好指标、颜色等
• 保存为模板（图表 → 模板 → 保存模板）
• 下次可快速应用

1. 多周期分析

• 同时运行多个不同周期的价差K线
• 例如：10秒、30秒、60秒
• 观察不同时间尺度的价差变化

1. 结合原品种图表

• 在原品种图表上观察详细价格
• 在价差图表上观察相对走势和交易信号
• 两个图表对照使用

交易技巧 ⭐ 新增

1. 先小手数测试

• 首次使用建议设置小手数（如0.1）
• 测试开仓和平仓流程
• 熟悉后再增加手数

1. 观察部分成功

• 注意查看”专家”标签页的日志
• 如果出现”⚠ 部分成功”，及时处理
• 避免单边持仓风险

1. 合理设置手数

• 双品种模式下，A和B使用相同手数
• 如需不同手数比例，请分别手动下单
• 考虑账户资金和品种保证金

1. 选择相关性强的品种对

• EUR/USD vs GBP/USD（相关性强）
• 黄金 vs 白银（相关性强）
• 避免不相关的品种对

1. 价差交易策略建议

• 在价差极端位置进场（均值回归策略）
• 设置合理的止损和止盈
• 注意相关性可能突然变化

---

? 常见问题 FAQ

Q1: 指标会占用很多资源吗？

A: 正常情况下占用很小。如果周期设置过小（如1秒）或回填时间过长（如1440分钟），可能会占用较多内存。

Q2: 生成的K线可以用于回测吗？

A: 可以。生成的品种像普通品种一样，可以被策略测试器读取（但历史数据有限）。

Q3: 如何删除生成的品种？

A:

1. 关闭所有使用该品种的图表
2. 按 Ctrl+U 打开”交易品种”窗口
3. 找到该品种，右键选择”删除”

Q4: 可以同时运行多个指标吗？

A: 可以。可以在不同图表上运行不同参数的指标，生成多个自定义品种。

Q5: 指标会自动保存数据吗？

A: 不会。每次重启MT5后，需要重新运行指标来生成K线。如果需要长期保存，建议导出历史数据。

Q6: 为什么我的价差K线一直是横线？

A: 可能的原因：

• 某个品种没有报价
• 品种名称输入错误
• 市场休市时段
• 查看”专家”标签的日志，会有详细错误提示

Q7: “强制K线连续”应该开启吗？

A:

• 关闭（推荐）：显示真实的价格变化，跳空是正常的
• 开启：K线视觉上连续，但开盘价不是真实的市场价格

Q8: 交易按钮没有出现怎么办？ ⭐

A:

1. 检查 启用交易功能 参数是否设为 true
2. 确认自定义品种图表已经打开
3. 等待几秒，按钮会自动显示
4. 如果仍未显示，尝试切换到自定义图表窗口

Q9: 双品种模式下，为什么点击”开多”会同时买入A和卖出B？ ⭐

A:
这是价差交易的标准逻辑：

• 做多价差 = 看涨A/B比例 = 买入A（涨获利）+ 卖出B（跌获利）
• 做空价差 = 看跌A/B比例 = 卖出A + 买入B
• 这样可以对冲市场整体波动，只赚取价差变化的利润

Q10: 如果双品种交易时A成功但B失败怎么办？ ⭐

A:
EA会显示警告：

⚠ 价差开多部分成功！A成功 B失败

建议处理方式：

1. 立即手动平掉A的持仓
2. 或重试B品种的开仓
3. 避免单边持仓暴露风险

Q11: 如何修改交易手数？ ⭐

A:
直接在图表上的”交易量”输入框中修改数值，然后点击交易按钮即可。支持小数（如0.01、0.5、2.5等）。

Q12: 双品种模式下可以只交易其中一个品种吗？ ⭐

A:
不可以。双品种模式下，交易按钮会自动配对交易A和B。如果只想交易单个品种，请将 品种B 参数留空，使用单品种模式。

Q13: MT5最小化后，在其他软件中按A/B/S/C键还会触发交易吗？

A: 不会！

指标已内置窗口焦点检查机制，确保只在MT5窗口激活时才响应快捷键。

保护机制：窗口焦点检查

• ✅ 只有MT5窗口处于活动状态（前台）时，快捷键才会响应
• ✅ MT5最小化或切换到其他软件时，快捷键自动失效
• ✅ 在Word、Excel、浏览器等软件中按A/B/S/C键，不会触发交易
• ✅ 切换回MT5窗口时，快捷键立即恢复正常

技术原理：

• 使用Windows API检测当前活动窗口是否为MT5进程
• 通过比较进程ID判断MT5是否为前台窗口
• 每50毫秒检查一次窗口焦点状态
• 当检测到MT5失去焦点时，立即重置所有按键状态

测试场景：

• ✅ MT5最小化 → 快捷键失效 ✓
• ✅ 切换到Word/Excel → 快捷键失效 ✓
• ✅ 切换到浏览器 → 快捷键失效 ✓
• ✅ 切换回MT5 → 快捷键立即恢复 ✓

Q14: 如果遇到”AutoTrading disabled by client”错误怎么办？

A: 这个错误（错误代码10027）表示MT5的自动交易权限未启用。

解决方法（任选其一）：

方法1：通过MT5选项启用

1. 工具 -> 选项
2. 找到"EA交易"标签
3. 勾选"允许自动交易"
4. 点击"确定"

方法2：通过指标属性启用

1. 图表右上角找到指标名称
2. 右键点击 -> 属性
3. 切换到"通用"标签
4. 勾选"允许自动交易"
5. 点击"确定"

方法3：通过工具栏启用

1. 点击MT5工具栏的"算法交易"按钮
2. 确保按钮显示为绿色（启用状态）
3. 如果是红色或灰色，再次点击启用

验证是否成功：

• 查看专家日志，应该显示”automated trading is enabled”
• 尝试再次使用快捷键或点击交易按钮
• 如果仍有问题，尝试重启MT5

---

? 使用示例：完整流程

示例：监控 EURUSD/GBPUSD 比例进行交易

第一步：添加指标

在 EURUSD 图表上添加 SpreadCandles 指标
参数设置：
  品种A: EURUSD
  品种B: GBPUSD
  UseRatio: true
  K线周期: 15
  回填历史: 120
  其他: 默认

第二步：观察价差图表

• 自动打开 EURUSD_GBPUSD.S15 图表
• 观察EUR/GBP比例的15秒K线
• 添加布林带指标观察上下轨

第三步：交易策略

• 当比例触及布林带上轨 → EUR相对超买
• 考虑：做空EURUSD + 做多GBPUSD
• 当比例触及布林带下轨 → EUR相对超卖
• 考虑：做多EURUSD + 做空GBPUSD

第四步：执行交易（传统方式）

• 在原 EURUSD 和 GBPUSD 图表上手动下单
• 价差图表仅用于信号参考

第四步（新方式）：使用一键交易 ⭐

• 在价差图表上直接点击”开多”或”开空”按钮
• EA自动同时交易A和B品种
• 一键完成配对交易，无需手动操作两个品种

---

示例2：使用交易功能进行价差套利 ⭐ 新增

场景：EUR/GBP 价差交易（完整流程）

第一步：配置EA

参数设置：
  品种A: EURUSD
  品种B: GBPUSD
  UseRatio: true (比例)
  K线周期: 10秒
  启用交易功能: true
  交易手数: 1.0
  显示调试日志: true (建议)

第二步：观察价差图表

• 自动打开 EURUSD_GBPUSD.S10 图表
• 观察EUR/GBP比例走势
• 在图表上添加技术指标（如布林带、均线等）

第三步：判断交易时机

假设当前比例 = 1.1500

• 情况1：价差触及历史低点（如1.1000）
• 判断：EUR相对GBP被低估
• 策略：做多价差（看涨EUR/GBP）
• 情况2：价差触及历史高点（如1.2000）
• 判断：EUR相对GBP被高估
• 策略：做空价差（看跌EUR/GBP）

第四步：执行交易（做多价差示例）

1. 开仓

• 在价差图表上点击”开多”按钮
• EA自动执行：
  【双品种价差交易】开多价差: A买入 + B卖出 → A品种买入: EURUSD 手数: 1.0 ✓ A品种买入成功 → B品种卖出: GBPUSD 手数: 1.0 ✓ B品种卖出成功 ✓✓ 价差开多完成！

1. 持仓阶段

• 观察价差K线走势
• 等待价差上涨到目标位

1. 平仓

• 当价差上涨到1.1800（目标位）
• 点击”平仓”按钮
• EA自动同时平掉EURUSD和GBPUSD持仓
• 获利了结

盈利计算：

EUR/GBP价差从1.1000上涨到1.1800
价差变化 = 1.1800 - 1.1000 = 0.0800 (8%)

假设：
- EURUSD从1.1000买入到1.1500平仓 → +500点
- GBPUSD从1.0000卖出到0.9700平仓 → +300点
总计：赚取价差扩大的利润

第五步：查看日志验证

• 在”专家”标签页查看详细日志
• 确认所有订单都已成功执行
• 检查是否有部分成功警告

---

? 交易功能详细说明

交易按钮界面

EA会在自定义品种图表的左上角显示交易按钮面板：

单品种模式：

┌──────────────────────────────────────────────────────┐
│ [开多] [开空] [全平] [平仓]  交易量: [1.00]          │
└──────────────────────────────────────────────────────┘

双品种模式 (按钮文字更明确)：

┌────────────────────────────────────────────────────────┐
│ [A多B空] [A空B多] [全平] [平仓]  交易量: [1.00]       │
└────────────────────────────────────────────────────────┘

按钮说明：

• 开多 / A多B空 (绿色按钮) – 单品种：买入A；双品种：买入A+卖出B
• 开空 / A空B多 (红色按钮) – 单品种：卖出A；双品种：卖出A+买入B
• 全平 (橙色按钮) – 平掉所有品种的所有持仓
• 平仓 (橙色按钮) – 平掉当前品种持仓
• 交易量输入框 – 可随时修改交易手数

单品种模式交易

品种B为空时，使用单品种模式

按钮	操作	说明
开多	A品种买入	使用设定手数开多单
开空	A品种卖出	使用设定手数开空单
平仓	平A品种持仓	按设定手数平仓
全平	平所有持仓	平掉账户所有品种

示例：

参数设置：
  SymbolA: EURUSD
  SymbolB: (留空)
  TradingLotSize: 1.0

点击"开多" → EURUSD 买入 1手
点击"平仓" → EURUSD 平仓 1手

双品种模式交易（价差交易）⭐⭐

品种B有值时，使用双品种配对交易模式

按钮	操作	说明
开多	A买入 + B卖出	做多价差（看涨A/B）
开空	A卖出 + B买入	做空价差（看跌A/B）
平仓	平A + 平B	按设定手数同时平仓
全平	平所有持仓	平掉账户所有品种

示例：做多 EUR/GBP 价差

参数设置：
  SymbolA: EURUSD
  SymbolB: GBPUSD
  UseRatio: true
  TradingLotSize: 1.0

当EUR/GBP价差被低估时：
  点击"开多" → EURUSD买入1手 + GBPUSD卖出1手

当价差回归时：
  点击"平仓" → 同时平掉EURUSD和GBPUSD持仓

日志显示：
  【双品种价差交易】开多价差: A买入 + B卖出
    → A品种买入: EURUSD 手数: 1.0
    ✓ A品种买入成功，订单号: 12345
    → B品种卖出: GBPUSD 手数: 1.0
    ✓ B品种卖出成功，订单号: 12346
  ✓✓ 价差开多完成！A买入 + B卖出

交易量调整

实时修改交易手数：

1. 点击”交易量”输入框
2. 输入新的手数（支持小数，如 0.1、0.5、2.0）
3. 点击任意交易按钮时自动应用新手数

手数范围：0.01 – 1000

键盘快捷键

快捷键说明：

• B键：开多
• S键：开空
• C键：平仓
• A键：全平所有持仓
• T键：测试交易功能

⚠️ 安全保护机制：

• ✅ 快捷键只在MT5窗口处于活动状态时生效
• ✅ 当MT5最小化或切换到其他软件时，快捷键自动失效
• ✅ 防止在使用Word、Excel等其他软件时误触发交易
• ✅ 切换回MT5窗口时，快捷键立即恢复响应
• ✅ 使用Windows API检测窗口焦点状态（每50毫秒检查一次）

交易前准备

1. 启用自动交易

• MT5工具栏上的”自动交易”按钮应为绿色
• 如果是红色，请点击启用

1. EA属性设置

• 右键点击EA → 属性
• 勾选”允许自动交易”
• 勾选”允许DLL导入”（如果需要）

1. 确认交易参数

• 检查交易手数是否合理
• 检查品种A和B是否正确
• 检查账户余额是否充足

---

? 总结

SpreadCandles 是一款灵活强大的工具，可以：

• ✅ 创建任意秒级K线
• ✅ 生成价差/比例K线用于套利交易
• ✅ 内置交易功能 – 一键配对交易 ⭐
• ✅ 智能模式识别 – 自动适配单品种/双品种
• ✅ 实时更新，无延迟
• ✅ 可与EA和技术指标配合使用
• ✅ 详细的交易日志和状态提示

核心优势

价差交易完整解决方案

• ? 价差K线可视化：实时显示价差走势
• ? 一键配对交易：自动同时交易A和B品种
• ⚡ 50ms快速响应：按钮点击立即执行
• ? 详细日志：每笔交易清晰记录
• ? 风险提示：部分成功自动警告

灵活的交易方式

• ?️ 点击按钮：在图表上直接点击
• ⌨️ 键盘快捷键：B/S/C/A键快速交易
• ?️ 安全保护：窗口焦点检查，防止误触发
• ? 可调手数：实时修改交易量
• ? 清晰界面：绿色开多、红色开空

立即开始使用，体验专业的价差交易工具！

---

? 版权信息

SpreadCandles 价差K线指标
版本：3.0 (含交易功能)
作者：Jacky
更新日期：2025-10-14

版本历史

• v3.0 (2025-10-14): 添加完整的交易功能，支持单品种和双品种配对交易
• v2.0: 优化价差K线生成算法
• v1.0: 初始版本，基础价差K线功能

---

? 相关文档

• SpreadCandles交易功能说明.md – 交易功能详细说明
• 双品种价差交易说明.md – 价差交易原理和实例
• 面板布局说明.md – 界面布局技术说明

---

如有问题或建议，请查看 MT5 “专家” 标签的日志输出，会有详细的运行信息。

? 快速参考表

交易按钮功能速查

按钮文字	单品种模式	双品种模式（价差交易）
? 开多 / A多B空	A 买入	A 买入 + B 卖出
? 开空 / A空B多	A 卖出	A 卖出 + B 买入
? 平仓	平A(设定手数)	平A + 平B(设定手数)
? 全平	平所有品种	平所有品种

注意：双品种模式下，按钮文字会自动变为”A多B空”和”A空B多”，更清晰地显示操作内容。

键盘快捷键速查

快捷键	功能	说明
B	开多	Buy – 买入
S	开空	Sell – 卖出
C	平仓	Close – 平仓（设定手数）
A	全平	All Close – 全平所有持仓
T	测试	Test – 测试功能

安全提示： 快捷键只在MT5窗口激活时生效，切换到其他软件时自动失效。

价差交易方向速记

做多价差 (看涨A/B)：
  开仓：A买入 ↑ + B卖出 ↓
  预期：A涨 > B涨（或A跌 < B跌）

做空价差 (看跌A/B)：
  开仓：A卖出 ↓ + B买入 ↑
  预期：A涨 < B涨（或A跌 > B跌）

---

⚠️ 风险提示

交易风险

• ⚠️ 交易存在风险，请谨慎操作
• ⚠️ 建议先在模拟账户充分测试
• ⚠️ 合理设置交易手数和止损
• ⚠️ 不要过度杠杆

价差交易特殊风险

• ⚠️ 品种相关性可能突然变化
• ⚠️ 部分成功时务必及时处理单边持仓
• ⚠️ 注意两个品种的点值和保证金差异
• ⚠️ 流动性差异可能导致滑点不同
• ⚠️ 重大新闻期间避免价差交易

最佳实践

• ✅ 小手数起步，逐步增加
• ✅ 设置止损，控制风险
• ✅ 定期查看日志，确认订单状态
• ✅ 选择相关性强的品种对
• ✅ 在流动性好的时段交易