Quote Price

GET

api

energy

quote

Quote Price

curl --request GET \
  --url https://api.example.com/api/v1/energy/quote

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/v1/energy/quote",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/v1/energy/quote"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v1/energy/quote")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "volume": 123,
  "duration": "<string>",
  "price_sun": "<string>",
  "rental_trx": "<string>",
  "fixed_fee_trx": "<string>",
  "total_trx": "<string>",
  "total_usd": {},
  "personal_price": true
}

Returns the exact amount that will be charged for a given energy volume — rental and fixed fee together, at your rate. This endpoint is public — authentication is optional. Send your API key to be quoted your own price; without it you get the public market price.

Use this endpoint when you need a price for a specific volume. GET /api/v1/prices always quotes 65,000 units and takes no parameters, and POST /api/v1/energy/estimate returns the rental only, at market price, ignoring your key.

Query parameters

integer

required

Energy units to price. Between 60,000 and 5,000,000.

string

default:"1h"

Rental period. Energy supports 1h only.

Headers

string

Optional. With a valid key the response reflects your negotiated rate and your fixed fee. An absent, invalid or revoked key is not an error — you simply get the public market price.

Response

number

Energy units the quote was calculated for

string

Rental period (1h)

string

Rate in SUN per 1 energy unit. Use it to price other volumes yourself: rental = volume × price_sun / 1,000,000

string

Rental cost for this volume, without the fixed fee

string

Fixed fee, charged once per order regardless of volume. Reflects your own fee if a custom fee, discount or waiver applies to your account.

string

What you will be charged: rental_trx + fixed_fee_trx

string | null

The same total in USD. null when the TRX/USD rate is momentarily unavailable — the TRX figures stay valid.

boolean

true when your negotiated rate was applied, false when the quote is at the public market price. Check it: a forgotten X-API-Key header otherwise looks like a normal response, and you would quote your customers the public price while being charged your own.

Example

curl "https://api.tronrental.com/v1/energy/quote?volume=131000&duration=1h" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

resp = requests.get(
    "https://api.tronrental.com/v1/energy/quote",
    params={"volume": 131000, "duration": "1h"},
    headers={"X-API-Key": "YOUR_API_KEY"},
)
print(resp.json()["total_trx"])

const resp = await fetch(
  "https://api.tronrental.com/v1/energy/quote?volume=131000&duration=1h",
  { headers: { "X-API-Key": "YOUR_API_KEY" } }
);
const quote = await resp.json();
console.log(quote.total_trx);

Values below are an example. Energy has a market price and it moves during the day.

Response

{
  "volume": 131000,
  "duration": "1h",
  "price_sun": "20.99",
  "rental_trx": "2.749690",
  "fixed_fee_trx": "0.2",
  "total_trx": "2.949690",
  "total_usd": "1.02",
  "personal_price": true
}

Common volumes

Volume	When
65,000	USDT transfer to a recipient that already holds USDT
131,000	USDT transfer to a recipient that has never held USDT (a new storage slot is created)

There is no catalogue of packages — any volume between 60,000 and 5,000,000 is valid, and the fixed fee is charged once per order either way. Two transfers to the same recipient are cheaper as one 131,000 order than as two 65,000 orders, because the fee is paid once instead of twice.

Errors

Code	Meaning
`400 INVALID_VOLUME`	Volume outside 60,000–5,000,000
`400 INVALID_DURATION`	Duration other than `1h`

An invalid or revoked X-API-Key is not an error here: the quote is returned at the public market price with personal_price: false.

Quote Price

curl --request GET \
  --url https://api.example.com/api/v1/energy/quote

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/v1/energy/quote",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/v1/energy/quote"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v1/energy/quote")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "volume": 123,
  "duration": "<string>",
  "price_sun": "<string>",
  "rental_trx": "<string>",
  "fixed_fee_trx": "<string>",
  "total_trx": "<string>",
  "total_usd": {},
  "personal_price": true
}

Core API

Bandwidth Rentals

Orders

Invoices

Smart Mode

Transfer Packages

Account

Webhooks

Quote Price

Quote Price

Query parameters

Headers

Response

Example

Common volumes

Errors

​Quote Price

​Query parameters

​Headers

​Response

​Example

​Common volumes

​Errors

Quote Price

Query parameters

Headers

Response

Example

Common volumes

Errors