使用文档

本文档介绍如何将 TradingView Pine Script 策略通过 Waka Bot 连接到 MT5 自动下单，以及如何配置警报 Message、EA 参数和风控规则。

快速上手

从零到自动下单，完成以下 5 步即可：

1. 注册账号

   前往 api.yunwaka.com/register，用邀请码注册后进入后台。

2. 生成 EA 参数

   登录后台 → 点击「生成新 EA」→ 复制 InpServerBaseUrl、InpEaId、InpEaToken 三个参数。

3. 在 MT5 中加载 EA

   下载 TVMT5_ServerBridge.ex5，放入 MT5 的 MQL5/Experts/ 目录，在目标图表上加载，填入上一步的三个参数，允许实盘交易。

4. 在 TradingView 创建警报

   在策略图表上右键 → 「添加警报」→ Webhook URL 填写后台提供的地址，Message 填写下方的完整 JSON 格式。

5. 验证执行

   触发一次策略信号，在后台「信号日志」查看执行状态，确认 MT5 已收到订单。

警报 Message 格式

在 TradingView 创建策略警报时，将以下 JSON 粘贴到「Message」输入框，TradingView 会在警报触发时自动替换 {{ }} 中的占位符。

复制{
  "action": "{{strategy.order.action}}",
  "market_position": "{{strategy.market_position}}",
  "prev_market_position": "{{strategy.prev_market_position}}",
  "symbol": "{{ticker}}",
  "volume": "{{strategy.order.contracts}}",
  "price": "{{strategy.order.price}}",
  "comment": "TVMT5_AUTO",
  "time": "{{time}}"
}

字段说明

如何在 TradingView 填写警报

1. 在已加载策略的图表上，点击「警报」图标（或按 Alt+A）
2. 「条件」选择你的策略名称，「触发」选择「订单成交」
3. 展开「通知」→ 勾选「Webhook URL」→ 粘贴后台提供的 Webhook 地址
4. 在「Message」文本框清空内容，粘贴上方完整 JSON
5. 点击保存，警报即生效

Pine Script 基础用法

绝大多数策略不需要任何改动，只要警报 Message 使用上方的 JSON 模板即可。系统通过 {{strategy.order.action}} 自动识别开多/开空/平仓。

一个最简单的均线交叉策略示例：

复制//@version=5
strategy("MA Cross", overlay=true, default_qty_type=strategy.fixed, default_qty_value=0.1)

fast = ta.ema(close, 9)
slow = ta.ema(close, 21)

if ta.crossover(fast, slow)
    strategy.entry("Long", strategy.long)

if ta.crossunder(fast, slow)
    strategy.entry("Short", strategy.short)

为上方策略设置警报，选择「订单成交」触发，粘贴标准 JSON Message，即可自动在 MT5 执行对应的买卖订单。

手数控制

手数由以下优先级决定（高优先级覆盖低优先级）：

1. EA 固定手数覆盖（InpOverrideLot = true）：无论信号带什么手数，一律使用 EA 设置的固定值。
2. 信号 volume 字段：来自 {{strategy.order.contracts}}，即策略 strategy.entry(qty=...) 的值。
3. 策略默认合约数：策略头部 default_qty_value 参数，未显式传 qty 时使用。

方式一：在 Pine Script 中指定手数

复制// 每次固定 0.1 手
strategy.entry("Long", strategy.long, qty=0.1)

// 根据账户净值动态计算（以 1% 风险为例）
risk_pct   = 0.01
stop_dist  = math.abs(close - ta.lowest(low, 20))
lot_size   = math.round(strategy.equity * risk_pct / (stop_dist * 100000) * 100) / 100
strategy.entry("Long", strategy.long, qty=lot_size)

方式二：在 EA 中统一覆盖手数

在 MT5 EA 设置中开启 InpOverrideLot = true，填写 InpFixedLot，则所有信号统一使用此手数，策略不需要传手数。适合固定仓位的简单策略。

常见策略示例

开多单 buy

复制strategy.entry("Long", strategy.long, qty=0.1)
// → action: "buy", market_position: "long"

开空单 sell

复制strategy.entry("Short", strategy.short, qty=0.1)
// → action: "sell", market_position: "short"

平多单（做空反转）

复制// 平掉多单，同时开空——MT5 收到 sell 指令
strategy.entry("Short", strategy.short, qty=0.1)
// → action: "sell", prev_market_position: "long", market_position: "short"

只平仓、不反向开仓

复制// 平多，不开空
strategy.close("Long")
// → action: "sell", prev_market_position: "long", market_position: "flat"

// 平空，不开多
strategy.close("Short")
// → action: "buy", prev_market_position: "short", market_position: "flat"

自定义订单备注

修改 Message JSON 中的 "comment" 字段值即可，不影响其他字段：

复制{
  "action": "{{strategy.order.action}}",
  "market_position": "{{strategy.market_position}}",
  "prev_market_position": "{{strategy.prev_market_position}}",
  "symbol": "{{ticker}}",
  "volume": "{{strategy.order.contracts}}",
  "price": "{{strategy.order.price}}",
  "comment": "MA_Cross_v2",
  "time": "{{time}}"
}

EA 参数说明

风控设置

在后台「策略风控」页面可以为每个策略独立配置以下限制，超出限制的信号会被自动拦截，不会到达 MT5。

action 值一览

系统支持以下 action 值。TradingView 策略警报只会产生 buy 和 sell；其余类型可通过直接调用 Webhook 手动触发。

常见问题

警报触发了但 MT5 没有下单？

• 确认 MT5 终端处于运行状态，且 EA 已加载并显示笑脸图标（表示实盘已允许）。
• 在后台「信号日志」查看该信号的状态和错误原因，常见原因：品种被风控拦截、EA Token 不匹配、MT5 连接断开。
• 确认 MT5 中该品种允许自动交易（右键品种 → 属性 → 交易）。

Message 里的手数和 MT5 下的手数不一致？

检查 EA 参数 InpOverrideLot 是否为 true。若启用了固定手数覆盖，EA 会忽略信号中的 volume，使用 InpFixedLot 值。

收到重复信号导致重复下单？

系统内置幂等键防护：相同 idempotency_key 的信号只会执行一次。若仍有重复，检查 Pine Script 是否在同一根 K 线发出多次警报（calc_on_every_tick = true 容易触发此问题）。

如何测试 Webhook 是否连通？

复制curl -X POST "https://api.yunwaka.com/webhook/<你的strategy_id>?secret=<你的secret>" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "buy",
    "symbol": "EURUSD",
    "volume": "0.01",
    "comment": "test",
    "idempotency_key": "manual-test-001"
  }'

返回 {"ok": true, ...} 表示连通正常。Webhook URL 和 secret 从后台「我的后台」EA 参数卡片中获取。

多个策略能同时运行吗？

可以。每次在后台「生成新 EA」都会产生一组独立的参数（InpEaId + InpEaToken + Webhook URL），在 MT5 不同图表上分别加载，策略之间完全隔离、互不干扰。