跳到主要内容

指南：面向地址群的 AutoEnergy

订阅一次地址，AutoEnergy 就会让它保持 Energy 就绪——每笔被覆盖的转账都自动处理并计费。你无需管理委托、时机或补充。本指南在一组地址上运行它。

所有调用都用你的 API key 鉴权：

Headers: { "X-API-Key": "ta_your_key_here" }

订阅一个地址​

POST https://tronagg.ai/api/v1/autoenergy/subscriptions
{
  "address": "TAddressOne...",   // 必填——唯一必需字段
  "idle_hours": 48,              // 可选：空闲 24 / 48 / 72 小时后自动关闭（默认 24）
  "quota_max_tx": 1000           // 可选：覆盖 N 笔转账后自动关闭（null = 不设上限）
}
{
  "address": "TAddressOne...",
  "status": "active",            // 订阅后短暂为 "pending_activation"
  "plan": {
    "activation_fee_trx": "3",   // 一次性，立即扣费
    "daily_sub_trx": "3",        // 生效期间每日扣费
    "unit_price_65k_trx": "1.7", // 每笔覆盖的转账，按 Energy 档位
    "unit_price_131k_trx": "2.1"
  },
  "tx_used_total": 0,
  "quota_max_tx": 1000,
  "idle_hours": 48,
  "expire_at": null,
  "activated_at": "2026-07-24T10:30:05Z"
}

逐个地址重复即可。循环可以安全重跑——两个 409 告诉你已有什么：

409 代码含义处理
address_busy该地址已有生效中的订阅。无需操作——已覆盖。
address_exists存在已关闭的订阅。POST .../{address}/reactivate

监控整组地址​

一个调用返回全部订阅及实时计数——这就是你的整组看板，按任意节奏重跑：

GET https://tronagg.ai/api/v1/autoenergy/subscriptions
[
  {
    "address": "TAddressOne...",
    "status": "active",
    "tx_used_total": 5,               // 已覆盖并计费的转账笔数
    "quota_max_tx": 1000,
    "last_activity_at": "2026-07-24T12:01:44Z",
    "closed_at": null,
    "close_reason": null
  },
  {
    "address": "TAddressTwo...",
    "status": "closed",
    "tx_used_total": 42,
    "close_reason": "quota"           // quota | expired | idle | insufficient_balance | manual | …
  }
]
  • GET .../subscriptions/{address} 返回单个地址的同样对象。
  • close_reason 视为开放集合——妥善处理未知值。

审计用量与账单​

按地址逐项查询：

GET https://tronagg.ai/api/v1/autoenergy/subscriptions/{address}/usage
[
  {
    "energy_class": "131k",           // 本笔转账覆盖的 Energy：65k 或 131k
    "used_tx_id": "7f00e1...",        // 消耗它的转账
    "billed_sun": 2100000,
    "billed_trx": "2.1",
    "occurred_at": "2026-07-24T12:01:44Z"
  }
]
GET https://tronagg.ai/api/v1/autoenergy/subscriptions/{address}/billing
[
  { "kind": "autoenergy_activate", "amount_trx": "3",   "at": "2026-07-24T10:30:05Z" },
  { "kind": "autoenergy_daily",    "amount_trx": "3",   "at": "2026-07-25T00:00:01Z" },
  { "kind": "autoenergy_unit",     "amount_trx": "2.1", "at": "2026-07-24T12:01:44Z" }
]

同样的 autoenergy_* 扣费也出现在账户级账本 GET /transactions 中。

关闭与重新激活​

POST https://tronagg.ai/api/v1/autoenergy/subscriptions/{address}/close
POST https://tronagg.ai/api/v1/autoenergy/subscriptions/{address}/reactivate
  • close 立即停止覆盖（close_reason: "manual"）；之后不再覆盖或计费。
  • reactivate 恢复已关闭的订阅并重置 tx_used_total。

完整示例（Python）​

fleet.py
import httpx

client = httpx.Client(
    base_url="https://tronagg.ai/api/v1",
    headers={"X-API-Key": "ta_your_key_here"},
)

FLEET = ["TAddressOne...", "TAddressTwo...", "TAddressThree..."]

for address in FLEET:                       # 订阅，可安全重跑
    resp = client.post("/autoenergy/subscriptions",
                       json={"address": address, "idle_hours": 48, "quota_max_tx": 1000})
    if resp.status_code == 409 and resp.json()["detail"]["error"] == "address_exists":
        resp = client.post(f"/autoenergy/subscriptions/{address}/reactivate")

for s in client.get("/autoenergy/subscriptions").json():   # 整组看板
    cap = s["quota_max_tx"] or "∞"
    print(f"{s['address']}: {s['status']} — {s['tx_used_total']}/{cap} 笔转账")

可选：实时事件​

如果轮询清单不够及时，注册一个 Webhook 获取推送：

没有 Webhook 时上面的一切照常工作。

下一步​