AutoEnergy API
工作台提供的每一项 AutoEnergy 操作都可通过 REST 调用。完整、可交互的接口参考——请求/响应结构、参数，以及"在线试用"控制台——位于 API Methods → AutoEnergy 区：
基础
- 基础路径：
https://tronagg.ai/api/v1/autoenergy - 鉴权： 请求头
X-API-Key: <你的密钥>—— 与其余程序化 API 使用同一密钥。可在工作台创建。 - 金额： 单位为 SUN（
1 TRX = 1,000,000 SUN）；响应同时包含用于展示的*_trx字符串字段。 - 归属范围： 每个按地址的接口都以
(你的用户, 地址)解析订阅。不属于你的地址与不存在的地址无法区分——都返回404 not_found，绝不返回403。
接口
| 方法 | 路径 | 参考 |
|---|---|---|
POST | /subscriptions | 订阅 |
GET | /subscriptions | 列出订阅 |
GET | /subscriptions/{address} | 获取订阅 |
PATCH | /subscriptions/{address} | 更新设置 |
POST | /subscriptions/{address}/reactivate | 重新激活 |
POST | /subscriptions/{address}/close | 关闭 |
DELETE | /subscriptions/{address} | 删除 |
GET | /subscriptions/{address}/usage | 列出用量 |
GET | /subscriptions/{address}/billing | 列出账单 |
GET | /pricing | 获取价格 |
错误标识
错误返回相应 HTTP 状态码，响应体形如 {"detail": {"error": <slug>, "message": …}}：
| 状态码 | error 标识 | 含义 |
|---|---|---|
422 | invalid_address | 地址格式错误。 |
409 | address_busy | 该地址已有一个有效订阅。 |
409 | address_exists | 你在该地址上已有一个已关闭的订阅——请先重新激活或删除。 |
409 | not_reactivatable | 只有已关闭的订阅可被重新激活。 |
409 | not_deletable | 只有已关闭的订阅可被删除。 |
404 | not_found | 你的账户下没有该订阅。 |
400 | insufficient_balance | 余额无法覆盖所需金额。 |
400 | plan_not_found | 引用的套餐不存在。 |
502 | fulfiller_unavailable | 当前无法激活/恢复能量委托——请稍后重试。 |
每个接口的完整请求/响应细节，请使用 API Methods → AutoEnergy 参考。