Production API
Quote an order
Calculate the current rental price for a TRON address without changing account balance.
POST
/v1/energy/quotesOn this page
A quote does not reserve funds or guarantee a future price. The final amount is fixed only when an order is created.
Request body
{"address":"TJRabPrwbZy45sbavfcjinPJC18kjpRTv8","energy":65000,"duration_minutes":60}
| Field | Type | Required | Description |
|---|---|---|---|
address |
string | yes | Valid TRON Base58Check destination address. |
energy |
integer | yes | Amount divisible by energy_per_portion. |
duration_minutes |
integer | yes | One allowed duration from options, in minutes. |
Unknown JSON properties are rejected.
Response 200
{"address":"TJRabPrwbZy45sbavfcjinPJC18kjpRTv8","energy":65000,"duration_minutes":60,"energy_trx":"3.200000","total_trx":"3.200000","can_afford":true}
| Field | Type | Description |
|---|---|---|
energy_trx |
string | Energy rental cost in TRX. |
activation_trx |
string, absent when unset | Address activation surcharge. The key is present only when the destination address needs activation, and left out of the response otherwise — the example above is a quote for an already active address. |
total_trx |
string | Full quoted amount. Always the value to send back as expected_total_trx, activation included. |
can_afford |
boolean | Whether the current available balance is sufficient. |
All money strings contain exactly six decimal places. The amounts here illustrate the format, not a tariff: the live price comes from your own quote.
Errors
400 means invalid fields or JSON, 413 an oversized body, 415 an invalid Content-Type, and 409 a state conflict. 401, 429, 500, and 503 are also possible.
Rentron