添加地址

POST 
/watch/addresses

在一个场景中开始监控最多 1,000 个地址。每个条目都有自己的结果，顺序与你发送的顺序相同，因此一行出错绝不会让整批失败：

• created：现已开始监控；
• exists：已在监控中（在此场景中，或在另一个场景中且 existing: "skip"）；其场景、标签和外部 ID 不变；
• moved：原在另一个场景中，且 existing 为 "move"；
• duplicate：同一地址在本次请求中已出现过；
• invalid：error 说明原因：invalid_address、invalid_label、invalid_external_id 或 external_id_taken；
• limit_exceeded：该场景的上限已无空位。条目按请求顺序接纳。

summary 统计每种状态的数量。add_on_deposit 阈值统计地址加入场景后转入、且尚未归集的 USDT。地址上原有的 USDT 不计入。

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、scenario_not_found。radar_disabled：此账户无法使用 TRONAgg Radar。

422

empty_batch、batch_too_large（超过 1,000 个条目；max）、invalid_existing。请求体或参数类型错误，或请求体中有未知字段时，则返回 FastAPI 的 detail 数组。

429

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

Response Headers

Retry-After

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