Skip to main content

Getting started

Two ways to start an AutoEnergy subscription: the workspace GUI (a few clicks) or the API (one call). Both create and activate the same subscription.

Before you start you need a funded TRONAgg balance. To subscribe, your balance must cover the entry threshold — the activation fee plus one daily fee plus one 131k transfer. Top up under Deposits in the workspace if needed. (See the current amounts via GET /pricing.)

Subscribe in the workspace​

  1. Sign in at tronagg.ai/workspace (Google, Telegram, or wallet) and open AutoEnergy in the sidebar — tronagg.ai/workspace/autoenergy.
  2. Click Add address and paste the TRON address you want kept Energy-ready.
  3. Optionally set:
    • Idle timeout — 24 / 48 / 72 hours before an inactive address auto-closes (default 24).
    • Max transactions — auto-close after this many transfers (optional).
    • Expiry date — auto-close at a set time (optional).
  4. Confirm. TRONAgg validates the address, charges the one-time activation fee, and parks the standing ~131,000 Energy delegation on the address within seconds.

The subscription now shows as active. From here you send USDT/TRC-20 from that address exactly as before — transfers spend delegated Energy, and each one is billed to your TRONAgg balance instead of burning TRX.

Subscribe via the API​

Every AutoEnergy operation is available under /api/v1/autoenergy, authenticated with the same X-API-Key as the rest of the programmatic API. If you don't have a key yet, create one from the workspace — see Authentication.

Create and activate a subscription:

curl -X POST https://tronagg.ai/api/v1/autoenergy/subscriptions \
  -H "X-API-Key: ta_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "TXYZ...yourAddress",
    "idle_hours": 24,
    "quota_max_tx": null,
    "expire_at": null
  }'

A 201 response returns the full subscription — status, counters, settings, and the plan's pricing snapshot. The pricing values below are illustrative placeholders; read live rates from GET /pricing:

{
  "address": "TXYZ...yourAddress",
  "status": "active",
  "plan": {
    "name": "Basic",
    "activation_fee_trx": "…",
    "daily_sub_trx": "…",
    "unit_price_65k_trx": "…",
    "unit_price_131k_trx": "…"
  },
  "tx_used_total": 0,
  "quota_max_tx": null,
  "expire_at": null,
  "idle_hours": 24,
  "activated_at": "2026-07-14T10:00:00Z",
  "closed_at": null,
  "close_reason": null
}

Check on it later:

curl https://tronagg.ai/api/v1/autoenergy/subscriptions/TXYZ...yourAddress \
  -H "X-API-Key: ta_your_key_here"

That's it — the address is now managed. See the API Reference for updating settings, viewing usage and billing, reactivating, closing, and deleting.

What's next​

  • How it works — billing, auto-close triggers, and billing guarantees.
  • API Reference — every endpoint with examples.
  • FAQ — pricing, edge cases, and troubleshooting.