ROLTHE
API REFERENCE

Energy API
Nine endpoints, from quote to reconciliation

Every endpoint authenticates with an HMAC-SHA256 signature. The base URL is https://api.rolthe.com/v1.

Auth & error codesWebhook API
Base URL
https://api.rolthe.com/v1
GET/energy/account

Get account

Balance, available balance and related figures for the current account.

Response example

200 OK
{
  "success": true,
  "code": 10000,
  "message": "ok",
  "data": {
    "user_id": 1,
    "username": "user@example.com",
    "balance": 100.5,
    "available_balance": 95.5,
    "frozen_amount": 5.0,
    "pending_orders_count": 2,
    "recharge_address": "TJCnKsPa7y5okkXvQAidZBzqx3QyQ6sxMW"
  }
}

Response fields

FieldTypeDescription
balancenumberTotal account balance (TRX)
available_balancenumberAvailable balance (TRX)
frozen_amountnumberFrozen amount (held by in-flight orders)
recharge_addressstringDeposit address
GET/energy/price

Get price

The current energy rental price.

Request parameters

ParameterTypeRequiredDescription
rent_timenumberNoRental duration in hours. Accepted values: 0.08 (5 min), 0.17 (10 min), 1 (1 hour)

Response example

200 OK
{
  "success": true,
  "code": 10000,
  "message": "ok",
  "data": {
    "price_65k_1hour": 1.86,
    "price_per_10k": 0.286154,
    "energy_per_transfer": 65000,
    "min_energy": 32000,
    "max_energy": 5000000,
    "rent_time": 1
  }
}
POST/energy/buy

Buy energy

Buy a given amount of energy for a given address.

Request parameters

ParameterTypeRequiredDescription
target_addressstringYesThe TRON address that receives the energy
energy_amountnumberNoAmount of energy, 65000 by default
rent_timenumberNoRental duration in hours, 1 by default

Request example

POST /energy/buy
curl -X POST "https://api.rolthe.com/v1/energy/buy" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-Timestamp: 1704067200" \
  -H "X-Signature: YOUR_SIGNATURE" \
  -H "Content-Type: application/json" \
  -d '{
    "target_address": "TJCnKsPa7y5okkXvQAidZBzqx3QyQ6sxMW",
    "energy_amount": 65000,
    "rent_time": 1
  }'

Response example

200 OK
{
  "success": true,
  "code": 10000,
  "message": "ok",
  "data": {
    "order_id": "EN240102ABC123",
    "tx_hash": "abc123...",
    "cost": 3.0
  }
}
POST/energy/auto-buy

Auto buy

The system works out how much energy is needed from from_address and to_address.

Request parameters

ParameterTypeRequiredDescription
from_addressstringYesSender address (the one that receives the energy)
to_addressstringYesRecipient address (used to detect a first-time transfer)
rent_timenumberNoRental duration in hours, 1 by default

Note

A first USDT transfer to a given address costs more energy than later ones. This endpoint works that out for you, so you do not buy the smallest bracket and come up short.

POST/energy/buy-count

Buy by transaction count

Energy priced by number of transfers — convenient for batch payouts.

Request parameters

ParameterTypeRequiredDescription
target_addressstringYesThe TRON address that receives the energy
countnumberNoNumber of transfers, 1 by default
rent_timenumberNoRental duration in hours, 1 by default
POST/energy/smart-buy

Smart buy

The full sequence in one call: check activation state → activate if needed → estimate energy precisely → buy.

Request parameters

ParameterTypeRequiredDescription
receiver_addressstringYesThe address that receives the energy (the USDT sender)
to_addressstringYesThe address that receives the USDT (checked for activation)
from_addressstringNoThe from address used for the simulated transfer; defaults to receiver_address
rent_timenumberNoRental duration in hours, 1 by default. Supports 0.25 (15m), 1 (1h), 24 (1d)

Response example

200 OK
{
  "success": true,
  "code": 10000,
  "message": "ok",
  "data": {
    "order_id": "EN240102ABC123",
    "activated": true,
    "energy_amount": 64300,
    "cost": 3.0
  }
}
POST/energy/check-address

Check address

Given a TRON address, report whether it needs activation and how many transfers’ worth of energy is required. Useful to tell the user before you charge them.

Request parameters

ParameterTypeRequiredDescription
addressstringYesThe TRON address to check

Response example

200 OK
{
  "success": true,
  "code": 10000,
  "message": "ok",
  "data": {
    "address": "THQvaTNagbBi5HRPxPMYSAh2kJDagEsq4V",
    "is_activated": false,
    "need_activate": true,
    "transfer_count": 2
  }
}
POST/energy/activate

Activate address

Activate an inactive TRON address. Inactive addresses cannot receive an energy delegation.

Request parameters

ParameterTypeRequiredDescription
addressstringYesThe TRON address to activate

Response example

200 OK
{
  "success": true,
  "order_id": "AC240102XYZ789",
  "tx_hash": "def456...",
  "cost": 1.1,
  "message": "Address activated"
}
GET/energy/order/{order_id}

Get order

Full detail for a single order by its ID.

Request parameters

ParameterTypeRequiredDescription
order_idstringYesOrder ID (path parameter)

Response fields

FieldTypeDescription
statusstringpending / processing / success / failed / cancelled
tx_hashstringOn-chain transaction hash of the energy delegation; only set once the order succeeds

Stuck on the integration?

Contact us