提醒语法

警报语法是信号来源用来描述一笔交易的确切文本格式，例如 TradingView 警报发送到 Webhook 的 JSON 消息，或 Telegram 频道所遵循的关键词格式；接收平台会将该语法解析为交易品种、方向、入场价、止损（SL）和止盈（TP）。

为什么重要

只有发送方和接收方在格式上达成一致，自动化才能生效。TradingView 允许你编写任意消息，并在警报触发时填充占位符（例如 ticker 和收盘价）；如果消息没有说明交易方向，或使用了接收方无法识别的字段名，警报会到达但不会有任何反应。TradingView 的默认文本（"BTCUSDT Crossing 60000"）完全不包含方向信息。在 Telegram 上没有统一标准，语法完全取决于该频道的惯用写法，而这种习惯上的微小变化就可能破坏解析。

AlgoVesta 如何处理

对于 TradingView，AlgoVesta 会为每个策略提供一个现成的 JSON 模板，占位符已预先设置好：交易品种取自 ticker，方向、来自收盘价的入场提示，以及可选的、来自绘图线或固定值的止损和止盈。该模板在仪表盘中生成，可原样复制到警报的消息框中。你未发送的字段将回退到机器人自身的规则，例如固定百分比止损。无法解析出方向的警报文本会被记录为已拒绝并注明原因，而不是被随意猜测。对于 Telegram，解析器可识别常见的关键词布局、表情符号标记、目标列表和止损写法，且每个频道都可以在模拟（paper）模式下测试，逐条查看每条消息被解析出的内容。相关文档参见 TradingView 机器人页面以及 Webhook 设置指南。

示例

某 TradingView 策略配置了如下消息：{"symbol":"{{ticker}}","side":"{{strategy.order.action}}","price":{{close}},"stop_loss":{{plot_0}},"take_profit":{{plot_1}},"market_position":"{{strategy.market_position}}"}。当 ETHUSDT 上触发多头入场时，TradingView 会将填充完毕的 JSON 发送到该策略的 Webhook URL；AlgoVesta 读取方向 "buy"、入场提示以及两个绘图值，并按这些价位开仓。第二条使用默认文本 "ETHUSDT Crossing 3100" 的警报因不含方向信息而被拒绝。

常见错误

• 保留 TradingView 的默认警报文本未做修改。
• 仅使用 strategy.order.action 来处理平仓，导致本应平掉多头的 "sell" 反而开出了空头；应加入仓位状态信息，或使用平台自身的平仓处理方式。
• 手动编辑 JSON 时不小心破坏了引号或逗号，导致整条消息无法解析。
• 在与实际要交易的品种不同的图表上创建警报，导致 ticker 占位符填入了错误的交易品种。