Add Energy to an address
POST/watch/addresses/:address/energy
Buy Energy for the address's next transfer now, whatever its scenario's action, alert_only included. Paid from your TRONAgg balance.
energy_preset:65k(a recipient that already holds USDT) or131k(any recipient). Omitted: the scenario's preset.max_total_price_sun(optional): the most you'll pay, activation included:total_price_sun + activation_fee_sunfrom the quote. If the fresh price is higher, you get409 quote_expiredwith the newquoteand nothing is bought. Without it, the live price applies.
The same rules as automatic additions apply: the scenario's working hours, one addition in flight per address, and its daily_budget_sun (not times_per_address_day). alert_only scenarios never buy by themselves and have no budget: there, max_total_price_sun and your balance are the only caps. Radar also checks the address on the chain before anything is bought.
The response is the Action: reserved or ordered while the Energy is on its way, delivered once it arrived. address.energy.charged follows when it lands. This never moves USDT and never signs anything for you.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 409
- 422
- 429
Successful Response
insufficient_balance: your balance doesn't cover the order. current_balance and required_amount are SUN.
The X-API-Key header is missing, invalid or revoked. detail is a plain string: API key required, Invalid API key or User not found.
radar_access_required: the account has neither a Google sign-in nor 1 TRX of net confirmed deposits; required_deposit_sun and allowed_auth_methods say what unlocks it. The API-wide refusals also apply: a blocked account (plain-string detail) and ip_not_allowed.
radar_disabled, address_not_found. radar_disabled: TRONAgg Radar isn't available for this account. radar_disabled also means Energy additions are switched off for now.
Nothing was bought: already_ready (the address has enough Energy), in_flight (an addition is already on its way), budget_exhausted (the scenario's daily budget), quote_expired (the price is above max_total_price_sun; quote is the new one), frozen, energy_paused, outside_hours, no_bandwidth, contract (a contract address can't receive Energy), autoenergy_active (an AutoEnergy subscription covers the address).
invalid_address, invalid_energy_preset (only 65k or 131k). A body or parameter of the wrong type, or an unknown body field, returns FastAPI's detail array instead.
Rate limit exceeded: more than 1,000 requests per minute for your account (shared by all of its API keys and workspace sessions). detail is a plain string; wait the number of seconds in Retry-After, then retry.
Response Headers
Seconds until the rate-limit window resets.