创建场景

POST 
/watch/scenarios

创建一个场景：Radar 对一组地址执行的操作。只有 name 和 action 为必填；其他字段都有默认值。

• action：alert_only（只发送提醒，从不购买能量）、add_on_deposit（入账累计达到 threshold 时添加一笔转账所需的能量，默认 "100"）或 add_after_transfer（每笔使用了能量的转账之后，为下一笔转账添加能量）。
• threshold：统计地址加入场景后转入、且尚未归集的 USDT。地址上原有的 USDT 不计入。
• energy_preset：65k（收款方已持有 USDT，默认）、131k（任意收款方）或带 energy_custom 的 custom。
• energy_alerts：能量警告（address.energy.insufficient、address.trx.low）。省略时，alert_only 关闭，能量类操作开启（能量类操作始终发送警告）。
• notify_destination_ids：null 发送到所有渠道（包括新渠道），[] 只把提醒留在 Radar 中，列表则只发送到这些渠道。

名称在每个账户内唯一。创建场景不产生任何费用：只有当其中的地址需要能量时才会购买。

请求

Responses

201

成功响应

401

X-API-Key 请求头缺失、无效或已撤销。detail 为纯字符串：API key required、Invalid API key 或 User not found。

403

radar_access_required：该账户既没有 Google 登录，也没有 1 TRX 的已确认净充值；required_deposit_sun 和 allowed_auth_methods 说明如何解锁。API 通用的拒绝同样适用：账户已被封禁（纯字符串 detail）以及 ip_not_allowed。

404

radar_disabled。radar_disabled：此账户无法使用 TRONAgg Radar。

409

scenario_name_taken：你已有同名场景。

422

Radar 无法接受的输入，由 field 指明是哪一项：invalid_name、invalid_action、invalid_threshold、invalid_energy_preset、invalid_energy（自定义能量超出 energy_min…energy_max）、invalid_times_per_address_day、invalid_daily_budget（超出 min_sun…max_sun）、invalid_energy_alerts、invalid_active_hours、invalid_usdt_low_threshold、invalid_destinations（unknown 列出不属于你的渠道 ID）。请求体或参数类型错误，或请求体中有未知字段时，则返回 FastAPI 的 detail 数组。

429

Rate limit exceeded：你的账户每分钟请求超过 1,000 次（由该账户的所有 API 密钥与工作台会话共用）。detail 为纯字符串；等待 Retry-After 给出的秒数后再重试。

Response Headers

Retry-After

距离限流窗口重置的秒数。