为地址添加能量

POST 
/watch/addresses/:address/energy

立即为该地址的下一笔转账购买能量，无论其场景的操作是什么，包括 alert_only。从你的 TRONAgg 余额中支付。

• energy_preset：65k（收款方已持有 USDT）或 131k（任意收款方）。省略时：使用场景的预设。
• max_total_price_sun（可选）：你愿意支付的最高金额，含激活费：即报价中的 total_price_sun + activation_fee_sun。如果最新价格更高，你会收到带有新 quote 的 409 quote_expired，且不会购买任何能量。不传时按实时价格。

与自动添加相同的规则同样适用：场景的工作时间、每个地址同时只有一次添加在途，以及场景的 daily_budget_sun（不受 times_per_address_day 限制）。alert_only 场景从不自行购买，也没有预算：在这类场景中，只有 max_total_price_sun 和你的余额会限制花费。Radar 还会在购买之前在链上检查该地址。

响应是该 Action：能量在途时为 reserved 或 ordered，到账后为 delivered。能量到账时随后会发送 address.energy.charged。此操作从不转移 USDT，也从不替你签署任何内容。

请求

Responses

200

成功响应

400

insufficient_balance：你的余额不足以支付该订单。current_balance 和 required_amount 以 SUN 计。

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、address_not_found。radar_disabled：此账户无法使用 TRONAgg Radar。radar_disabled 也表示能量添加目前已关闭。

409

未购买任何能量：already_ready（该地址的能量已足够）、in_flight（已有一次添加正在途中）、budget_exhausted（场景的每日预算已用完）、quote_expired（价格高于 max_total_price_sun；quote 为新报价）、frozen、energy_paused、outside_hours、no_bandwidth、contract（合约地址无法接收能量）、autoenergy_active（该地址已由 AutoEnergy 订阅覆盖）。

422

invalid_address、invalid_energy_preset（只能是 65k 或 131k）。请求体或参数类型错误，或请求体中有未知字段时，则返回 FastAPI 的 detail 数组。

429

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

Response Headers

Retry-After

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