Skip to main content
POST
/
api
/
v1
/
energy
/
buy
Buy Energy
curl --request POST \
  --url https://api.example.com/api/v1/energy/buy \
  --header 'Content-Type: application/json' \
  --data '
{
  "target_address": "<string>",
  "volume": 123,
  "duration": "<string>"
}
'
{
  "id": 123,
  "status": "<string>",
  "txid": {},
  "price_trx": "<string>",
  "reclaim_at": {},
  "activation_cost_trx": "<string>"
}

Buy Energy

Delegates energy to the specified TRON address. The cost is deducted from your account balance.

Request body

target_address
string
required
Target TRON address (T… format, 34 characters)
volume
number
required
Amount of energy to delegate (min 32,000, max 5,000,000)
duration
string
required
Rental duration: "1h" (1 hour) or "1d" (1 day, bandwidth orders only)

Response

id
number
Unique order identifier
status
string
Order status: pending, filled, failed
txid
string | null
On-chain transaction id once the delegation is broadcast (null while pending)
price_trx
string
Total cost charged from your balance, in TRX
reclaim_at
string | null
ISO 8601 timestamp when the bandwidth rental is reclaimed (energy is reclaimed automatically by the provider)
activation_cost_trx
string
Address activation cost in TRX ("0" if the recipient is already activated)

Example

curl -X POST https://api.tronrental.com/v1/energy/buy \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "target_address": "TYourRecipientAddress1234567890abc",
    "volume": 65000,
    "duration": "1h"
  }'
Response
{
  "id": 12345,
  "price_trx": "2.75",
  "status": "pending"
}
65,000 energy covers one USDT transfer to an address that already holds USDT. Use 131,000 for first-time USDT recipients (new storage slot creation).