MMC Trading

每条交易可以创建一个专属 webhook：触发后推送到绑定的 Telegram 群。

核心模型

1 笔交易 = 1 个 webhook（避免“群里只有提醒但不知道对应哪条交易”）。
webhook URL 形态：/webhook/trade-alert/:triggerToken/:tradeShortId
每个 webhook 绑定一个 Telegram 群：群内发送 /bind <bindCode>
防滥用：每个 webhook 限流 1 分钟最多 1 次
配额：按用户等级限制可创建的 webhook 数量（Pro 1 个；Admin/SuperAdmin 5 个；Free 提示升级）。

用户教程：从 0 到跑通

1) 创建 Telegram 群

在 Telegram 新建一个群（建议专门用于交易提醒/讨论）。
把你的队友/小号拉进群（可选）。

2) 创建 Trade webhook

打开某条交易详情页，在「TradingView Webhook（此交易）」区块点击「创建 webhook」。创建成功后会拿到：triggerUrl（TradingView 要填的 URL）和 bindCode（群绑定用）。

3) 把 bot 拉进群并绑定

把官方 bot 拉进你刚创建的 Telegram 群。
在群里发送：

/bind <bindCode>

绑定成功后，这条交易的 TradingView 触发会推送到该群。

推荐做法：把你所有交易的 webhook 都绑定到同一个“交易群”，这样你的 clawbot 只需要进一个群就能统一接收与分析。

4) 配置 TradingView alert

在 TradingView 的 Alert 配置里，把 webhook URL 填成你刚创建得到的 triggerUrl。 body 建议至少包含一段可读消息：

{ "message": "BTCUSDC 回踩关键位，计划 A 触发" }

给 Clawbot 用的结构化信息

系统推送到 Telegram 群的消息会包含一个 META_JSON 代码块，里面有：transactionId / tradeShortId 等字段。你的 clawbot 可以从群消息中解析这些字段后，用你自己的 API Token 调用 /trade/* 接口拉取该交易的分析数据，再结合 webhook 的 message 做二次分析。

关于“分析 bot”

Pro 用户未来可开启“自动分析报告”：系统会把该交易里写的计划/关键位/风控，与 TradingView 触发上下文一起生成结构化报告，并回到同一个群。

开发者教程：接口与调试

触发方式（推荐：前端代理）

推荐使用前端代理（更稳定，也避免暴露后端真实 base URL）：POST /api/webhook?token=tw_xxx&tradeShortId=tr_xxx

curl -X POST "https://<YOUR_FRONTEND_ORIGIN>/api/webhook?token=tw_xxx&tradeShortId=tr_xxx" \
  -H "Content-Type: application/json" \
  -d '{"message":"BTCUSDC 回踩关键位"}'

限流与配额

限流：同一个 webhook 1 分钟最多触发 1 次。
配额：Pro 1 / Admin 5 / Free 提示升级。

后端直连触发接口（直连）

POST https://<YOUR_API_BASE>/webhook/trade-alert/:triggerToken/:tradeShortId
Body: { "message": "..." }
(无需额外 header)

Next steps：快速开始或API Token 使用指南

Webhook 使用指南（TradingView → Telegram，按交易绑定）