Who is the TRON Energy API for?
Anyone who sends USDT on TRON from code, often enough that 6.50 TRX burned per transfer adds up.
Rent Energy for the hot wallet before each withdrawal batch.
One idempotent rental per payout, keyed by your payout ID.
No account at all with x402: quote, pay in USDC, poll.
Account API or x402: which should you use?
| Account API | x402 | |
|---|---|---|
| Sign-up | Account with an API key | None: no account, no API key |
| Pay with | Prepaid TRX balance | USDC on Base (preferred) or Solana, per rental |
| Price lock | Until the quote's valid_until | 10 minutes, Energy price and TRX/USD rate |
| Track | GET /v1/operations/{id} | The quote's status_url |
| Best for | Steady volume, one bill | Agents, one-off scripts, no stored balance |
How to rent TRON Energy with the account API
- Create an API key
Sign in with Telegram or Google, open API and create a key. The full value is shown only once. Send it as
Authorization: Bearer <key>. - Lock a price
POST /v1/quotes/energywithenergy_amount,duration_seconds(3600 or 86400) and thetarget_addressthat will send the USDT. The response holdsquote_id,price_trx,valid_untiland the estimated saving against burning. - Rent with the quote
POST /v1/rentalwith thequote_idand anIdempotency-Keyheader. Funds are reserved from your balance and the rental is queued; the reply is202with aLocationto the operation. - Wait for delivery, then send USDT
Poll the operation until it succeeds, then sign the transfer from the target address.
/v1/quotes/energyLock a price/v1/rentalRent Energy/v1/operations/{id}Track deliveryCustom amountsSet custom_amount to true for amounts other than 65,000 or 130,000. The current minimum is published by the API; the reference explains where to read it.
Read TRON Energy prices without a key
GET https://tronenergyfrog.com/api/v1/rates/energy/default returns the public price for 65,000 Energy for 1 hour, the TRX that the same Energy would burn, the saving, and hourly history. Add ?history=1d, 7d, 30d or 90d. Responses are cached for 30 seconds.
{
"energy_amount": 65000,
"duration_seconds": 3600,
"price_trx": "2.05",
"average_commission_trx": "6.5",
"savings_trx": "4.45",
"savings_percent": "68.46",
"network_fee_updated_at": "2026-11-17T12:00:00Z",
"price_history": {
"window_hours": 168,
"median_price_trx": "1.59",
"current_vs_median_percent": "28.9",
"points": [ … ]
}
}Use it for dashboards and price alerts. For an order, always request a quote: the public rate is a reference, not a locked price.
x402: rent TRON Energy with USDC, no account
No registration, account, API key or prepaid balance is required. Discover the live contract at GET /v1/x402, then follow the standard x402 flow. Field-level schemas are in the x402 section of the API reference.
- Read the capability endpoint
GET /v1/x402lists the current endpoints and supported payment networks. - Create a free quote
POST /v1/x402/quoteswith thetarget_address(and optionallyenergy_amount,duration_seconds). It locks the Energy price and TRX/USD conversion for ten minutes. - Get the payment challenge
POST the returned
payment_urlonce without a signature. The reply is402 Payment RequiredwithPAYMENT-REQUIRED. - Pay and retry
Pay one advertised option from the agent's wallet and retry the same URL with
PAYMENT-SIGNATURE. A successful settlement returnsPAYMENT-RESPONSE. - Poll the status URL
status_urlreports both payment settlement and Energy delivery.
| Priority | Asset | Network | Use |
|---|---|---|---|
| Preferred | USDC | Base | First choice for compatible agents |
| Fallback | USDC | Solana | When the agent is funded on Solana |
The 402 response is the source of truthfor network identifiers, token addresses, recipients, expiry and the exact atomic amount. Bots should read API responses rather than scrape this page for prices.
How do I know the Energy was delivered?
Every rental is an operation. Poll GET /v1/operations/{id} until it reaches a final status; a succeeded operation carries the delegation txid you can open on TronScan.
| Status | What to do |
|---|---|
| queued processing submitted | Keep polling. Don't send USDT yet. |
| succeeded | Energy is on the target address. Send the transfer while the rental is active. |
| failed | Read error_code. Don't send USDT on the assumption that Energy arrived. |
| unknown | The result isn't confirmed yet. Keep polling; see the reference for handling. |
History endpoints and project IDs for matching operations to your own orders are described in the API reference.