接入文档

接入步骤

1. 先在策略管理页创建策略实例。
2. 在策略详情里复制该策略专属的 Webhook URL 和 Secret Key。
3. 在 TradingView 告警里把 Webhook URL 粘贴到 Webhook URL 输入框。
4. 把告警消息内容改成 JSON 或文本格式，并带上 secret_key。
5. 首次发送后，去日志页查看命中结果、执行状态和错误原因。

推荐 JSON 示例

{
  "signal_id": "tv-btc-001",
  "secret_key": "你的策略 Secret",
  "symbol": "BTC_USDT",
  "action": "open",
  "side": "buy",
  "contracts": 0.01,
  "price": "market"
}

推荐优先使用 JSON，字段更稳定，日志也更容易排查。

文本格式也支持

signal_id=tv-btc-001
secret_key=你的策略 Secret
symbol=BTC_USDT
action=open
side=buy
contracts=0.01

如果你当前 TradingView 模板是纯文本，也可以直接发；后端会自动解析常见 key=value 文本格式。

常用字段

• signal_id: 信号唯一标识，建议每条信号唯一。
• secret_key: 策略实例对应的密钥，缺少或不匹配会被拒绝。
• symbol: 交易对，例如 BTC_USDT。
• action: open、close、update。
• side: buy、sell、long、short。
• contracts: 下单数量或张数。
• price: 可选，默认可按市价处理。

发送结果说明

• 200: Webhook 已接收并进入后续处理。
• 400: 消息格式错误，常见于 JSON 结构不合法或缺少关键字段。
• 403: secret_key 不匹配，或策略未启用。
• 日志页显示 failed: 说明请求已进入执行链路，但在账户、风控或交易所阶段失败。

排查建议

• 先确认策略实例已启用，并且已绑定至少一个执行账户。
• 确认 API 账户密钥完整，尤其是 OKX / Bitget / HTX 的 Passphrase。
• 确认 Webhook URL 和 Secret 来自同一个策略实例，不要混用。
• 发送后立刻去日志页查看 signal_id、状态和原因字段。

相关入口

• 控制台
• 服务说明
• 风险提示
• 隐私政策