TronEnergyFrog

Developers · REST and x402

TRON Energy rental API

Three calls rent Energy from your backend: POST /v1/quotes/energy locks a price, POST /v1/rental rents it, and GET /v1/operations/{id} confirms delivery. Public rates need no key. Bots and AI agents without an account can pay per rental in USDC with x402.

On this page
  1. Who it's for
  2. Account API or x402
  3. Rent with the account API
  4. Public rates, no key
  5. x402: pay in USDC
  6. Track delivery
  7. API questions
# 1. Lock a price for 65,000 Energy, 1 hour
curl -X POST https://api.tronenergyfrog.com/v1/quotes/energy \
  -H "Authorization: Bearer $TEF_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"energy_amount":65000,"duration_seconds":3600,
       "target_address":"TQ5nW3…8k2Wd"}'
# → { "quote_id": "1111…", "price_trx": "…", … }

# 2. Rent it. Retries with the same key never rent twice.
curl -X POST https://api.tronenergyfrog.com/v1/rental \
  -H "Authorization: Bearer $TEF_API_KEY" \
  -H "Idempotency-Key: payout-2026-0042" \
  -H "Content-Type: application/json" \
  -d '{"quote_id":"1111…"}'
# → 202 Accepted · Location: /v1/operations/3333…

# 3. Track delivery
curl https://api.tronenergyfrog.com/v1/operations/3333… \
  -H "Authorization: Bearer $TEF_API_KEY"
# → { "status": "succeeded", "txid": "…" }
Shortened example; addresses and IDs are placeholders.Full schemas in the reference
Calls to rent Energy
3Quote, rent, track
65K Energy, 1 hour, today
1.55 TRX≈ $0.47 against 6.50 TRX burned
Account needed for x402
0Pay per rental in USDC
x402 quote holds the price for
10 minutesEnergy price and TRX/USD rate

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.

Exchanges and wallets

Rent Energy for the hot wallet before each withdrawal batch.

Payout and payment systems

One idempotent rental per payout, keyed by your payout ID.

Bots and AI agents

No account at all with x402: quote, pay in USDC, poll.

Account API or x402: which should you use?

Account APIx402
Sign-upAccount with an API keyNone: no account, no API key
Pay withPrepaid TRX balanceUSDC on Base (preferred) or Solana, per rental
Price lockUntil the quote's valid_until10 minutes, Energy price and TRX/USD rate
TrackGET /v1/operations/{id}The quote's status_url
Best forSteady volume, one billAgents, one-off scripts, no stored balance

How to rent TRON Energy with the account API

  1. 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>.

  2. Lock a price

    POST /v1/quotes/energy with energy_amount, duration_seconds (3600 or 86400) and the target_address that will send the USDT. The response holds quote_id, price_trx, valid_until and the estimated saving against burning.

  3. Rent with the quote

    POST /v1/rental with the quote_id and an Idempotency-Key header. Funds are reserved from your balance and the rental is queued; the reply is 202 with a Location to the operation.

  4. Wait for delivery, then send USDT

    Poll the operation until it succeeds, then sign the transfer from the target address.

POST/v1/quotes/energyLock a price
POST/v1/rentalRent Energy
GET/v1/operations/{id}Track delivery

Custom 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.

Example response · illustrative values · average_commission_trx = TRX burned without Energy
{
  "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.

  1. Read the capability endpoint

    GET /v1/x402 lists the current endpoints and supported payment networks.

  2. Create a free quote

    POST /v1/x402/quotes with the target_address (and optionally energy_amount, duration_seconds). It locks the Energy price and TRX/USD conversion for ten minutes.

  3. Get the payment challenge

    POST the returned payment_url once without a signature. The reply is 402 Payment Required with PAYMENT-REQUIRED.

  4. Pay and retry

    Pay one advertised option from the agent's wallet and retry the same URL with PAYMENT-SIGNATURE. A successful settlement returns PAYMENT-RESPONSE.

  5. Poll the status URL

    status_url reports both payment settlement and Energy delivery.

PriorityAssetNetworkUse
PreferredUSDCBaseFirst choice for compatible agents
FallbackUSDCSolanaWhen 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.

StatusWhat to do
queued processing submittedKeep polling. Don't send USDT yet.
succeededEnergy is on the target address. Send the transfer while the rental is active.
failedRead error_code. Don't send USDT on the assumption that Energy arrived.
unknownThe 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.

API questions

Still unsure? Message support and a person answers.

Do I need an account to use the TRON Energy API?

For the account API, yes: create an API key in your account. The public rates endpoint and the x402 endpoints need no account or API key.

How are API rentals paid?

Account API rentals are paid from your prepaid account balance. x402 rentals are paid per rental in USDC, on Base (preferred) or Solana.

How do I avoid paying twice when a request is retried?

Send an Idempotency-Key header with POST /v1/rental. Repeating the request with the same key does not create a second rental.

Which x402 payment option should a bot choose?

USDC on Base when available, USDC on Solana as the fallback. The 402 response is the source of truth for networks, token addresses, recipients, expiry and the exact amount.

Where are the full request and response schemas?

In the API reference, also available as OpenAPI JSON and Markdown.

About this page

Endpoints and field names match the published API reference. Code is shortened for reading; the reference has complete schemas and errors.

Reference
api.tronenergyfrog.com/v1/docsOpenAPI JSON and Markdown versions linked there
Prices
Public rate API, Nov 22, 2026, 12:32 UTC
x402
x402 payment flow, USDC on Base and Solana
Reviewed
17 Nov 2026 · TronEnergyFrog team

Rent your next 65K for 1.55 TRX instead of burning 6.50 TRX

Try a rental on the website first, then automate it. No account is needed for a guest rental, and nothing is charged until you pay.

Your next transfer

Energy needed
65,000
Without Energy
6.50 TRX burned ≈ $1.98
With TronEnergyFrog
1.55 TRX ≈ $0.47
You keep
4.95 TRX ≈ $1.51
65K Energy, 1 hour1.55 TRX ≈ $0.47
Rent Energy