文档

风险引擎与 Webhook 参考

AlgoVesta 如何在执行前验证每个信号，以及从 TradingView 或任何 webhook 来源发送的确切 JSON 载荷。字段名是字面量 — 原样复制即可。

AlgoVesta 从三个触发渠道执行交易: 面向 AI 助手的 MCP 服务器、Telegram 信号和 TradingView Webhook。无论哪个渠道触发,同一个服务器端风控引擎都会在订单到达您的交易所或 MetaTrader 5 账户之前对其进行验证。本页是涵盖这三者的技术参考中心。

触发交易的三种方式

每个渠道最终都走向相同的执行路径:验证、计算仓位、下单,然后在交易所本身设置止损和止盈。请选择与您现有操作方式相匹配的渠道。

面向 AI 助手的 MCP 服务器

通过一条经过认证的连接,将 Claude、ChatGPT、Cursor 或任何支持 MCP 的客户端接入二十个原生交易工具。每个连接都以 5,000 美元的模拟账户余额开始,实盘密钥需要通过双重验证单独创建。认证方式为使用 PKCE(S256)的 OAuth 2.1,或按用户分配的密钥链接。

MCP 开发者参考文档连接 AI 助手

Telegram 信号频道

将 AlgoVesta 指向您已经关注的信号频道。消息会被解析为品种、方向、入场价、止损和目标价,随后在您的交易所执行或转发至 MetaTrader 5。无法明确解析的信号会被拒绝,而不是被猜测处理。

从 Telegram 到 MetaTrader 5连接一个 Telegram 频道

TradingView Webhook

从任意指标、画线工具或 Pine 策略向您的专属 Webhook URL 发送警报。警报正文必须是符合下方记录格式的有效 JSON,并且每个自动交易信号的来源都会在下单前经过验证。

TradingView 自动化载荷参考文档

风险引擎：信号如何被验证

信号绝不会被盲目执行。在下单之前，它会经过一个多模块验证层，将其与实时行情和你设定的限制进行核对。若某项硬性规则未通过，信号会被拒绝 — 而不是缩小仓位。

神经评分 — 来自评分模型的 0–100 置信分数。
成交量与订单流 — 成交量激增与激进成交失衡（VPIN）。
市场状态 — 趋势 / 区间 / 均值回归 分类。
资金费率与强平 — 资金费率动态与强平聚集区。
止损映射 — 避免把止损放在已知的流动性聚集区内。
你的硬性规则 — 方向、交易时段、仓位与回撤限制。

确切的模块组合与阈值会随平台调优而变化。原则不变：在订单到达你的交易所之前，你的规则和风险限制始终会被应用。

每日亏损与回撤保护

除了逐信号检查外，两项账户级保护持续运行。

每日亏损上限 — 当你当日的已实现亏损达到你设定的上限（余额的百分比或固定金额）时，AlgoVesta 进入安全模式，在次日之前停止开新单。
基于回撤的仓位 — 随着账户回撤增大，仓位规模会分阶段（谨慎 → 防御 → 生存）自动缩小，使连续亏损降低你的敞口而非放大它。

Webhook 载荷参考

向你的 AlgoVesta webhook URL 发送带 JSON 主体的 HTTP POST。在 TradingView 中，将其粘贴到警报消息框。字段名必须完全一致。

# POST https://api.algovesta.com/webhook/<your-token> { "symbol": "BTCUSDT", "side": "buy", "price": 64250.0, "stop_loss": 63800.0, "take_profit": 65100.0 }
字段必填说明
symbol是交易所交易对，例如 BTCUSDT。
side / action是订单方向：buy 或 sell。
price可选入场参考价；市价入场可省略。
stop_loss可选止损价。建议每个信号都设置。
take_profit可选止盈价。可在应用内配置多个目标。
market可选目标市场：crypto（默认）或 forex。设为 forex 时发送至 MetaTrader 5。绝不会根据交易对推断。
lots可选仅限外汇 — 以手数表示的仓位大小。留空则使用你已配置的手数/风险模式。
leverage可选仅限加密货币 — 适用交易所对该交易对的限制。
amount_usd可选仅限加密货币 — 指保证金，而非名义价值。名义价值 = 保证金 × 杠杆。
risk_percent可选仅限加密货币 — 承担风险的余额百分比（0.1–50）。
quantity可选仅限加密货币 — 精确的合约数量。qty、size 和 contracts 均可作为别名。
take_profits可选多个目标价：[{"price":…, "close_pct":…}]。tp1…tp5 搭配 tpN_close 同样可用。
trailing可选{"trigger_pct":…, "distance_pct":…} — 追踪止损。
breakeven可选true 或 {"trigger_pct":…} — 一旦盈利即把止损移至开仓价。

交易所前缀会被去除，因此 BINANCE:BTCUSDT 与 BTCUSDT 效果相同。在方向字段中，direction 和 type 可作为 action 的别名，close 也是有效取值。

仓位大小、杠杆和每个信号的风险可以来自您的仪表盘，也可以来自载荷——载荷中的值优先。这正是 webhook 网址是密钥的原因：添加一个 IP 白名单，这样 AlgoVesta 就只会自动交易能够核实来源的信号。

平仓

连同交易对一起发送 "action": "close"。该交易对的整个仓位都会被平掉 — 不支持部分平仓；即使你请求部分平仓，也会平掉全部仓位，面板会明确说明这一点。

{ "symbol": "BTCUSDT", "action": "close" }

Pine 策略警报 — 平仓自动处理

如果你使用勾选了“Order fills only”的 Pine strategy() 创建警报，请不要只发送 action：{{strategy.order.action}} 在平仓时同样返回 sell，这会开出一个空头仓位而不是平仓。请附带仓位状态字段，AlgoVesta 会为你判断开仓、平仓与反手。

{ "symbol": "{{ticker}}", "action": "{{strategy.order.action}}", "market_position": "{{strategy.market_position}}", "prev_market_position": "{{strategy.prev_market_position}}", "position_size": "{{strategy.position_size}}" }
成交后的仓位AlgoVesta 的处理方式
flat (or position_size = 0)平掉仓位，不会开立反向订单。
与之前状态相反反手 — 先平仓，再按新方向开仓。若平仓失败，则不会开任何仓位。
与之前方向相同视为该方向的一次开仓。

消息必须是 JSON。 当内容不是有效的 JSON 时，TradingView 会以纯文本发送警报正文 — 其默认消息（例如“BTCUSDT Crossing 1.00”）不含方向信息，会被拒绝。我们绝不会对含糊的文本进行猜测；拒绝一个信号比朝错误方向开单更安全。另请注意，TradingView 在 3 分钟内触发 15 次后会自动停止该警报。

无代码构建器
无需手写 JSON — 可视化生成

用简单的开关设置方向、止盈/止损（单个或多级）、杠杆、仓位大小、追踪止损和保本。AlgoVesta 会生成精确的 TradingView 警报消息 — 复制并粘贴到你的警报中。

了解可视化构建器的工作原理 → 分步设置警报 →

常见问题

哪些渠道可以在 AlgoVesta 上触发交易?

三个:AI 助手使用的 MCP 服务器、Telegram 信号频道和 TradingView Webhook。您也可以在仪表盘中手动开仓。每个渠道都会经过相同的执行路径和相同的风控检查。

TradingView 是否必须使用 Webhook JSON 格式?

会。当警报正文不是有效的 JSON 时,TradingView 会以纯文本形式发送,而其默认警报消息不携带方向信息,因此会被拒绝。请使用上方Webhook 载荷参考中记录的载荷格式,或通过可视化构建器生成结果后粘贴到警报中。

风控引擎是否也适用于 MCP 和 Telegram 订单?

是——每个渠道都会运行相同的服务器端检查。无论订单来自 AI 助手、Telegram 信号还是 TradingView 警报,在订单到达交易所之前,都会强制执行您的风控策略、止损要求以及仓位和回撤限制。任何提示词或消息都无法放宽这些限制。

在哪里可以找到完整的 MCP 工具参考文档?

MCP 开发者参考文档记录了全部 20 个工具、三种作用域、OAuth 2.1 与密钥链接认证、速率限制、错误代码,以及支持的 16 家交易所和 MetaTrader 5。

可以不用真实资金进行测试吗?

会。每个 MCP 连接都以按真实市场价格计算的 5,000 美元虚拟模拟账户余额开始,TradingView 和 Telegram 自动化都提供可模拟从信号到下单完整流程的演示模式。实盘交易始终需要单独、明确创建的密钥或连接。