Calcular preço

GET

api

energy

quote

Calcular preço

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
}

Retorna o valor exato que será cobrado por um volume de energia informado — aluguel e taxa fixa juntos, pela sua tarifa. Este endpoint é público — a autenticação é opcional. Envie sua chave de API para receber o seu preço; sem ela você obtém o preço público de mercado.

Use este endpoint quando precisar do preço de um volume específico. GET /api/v1/prices sempre cota 65.000 unidades e não aceita parâmetros, e POST /api/v1/energy/estimate retorna apenas o aluguel a preço de mercado, ignorando sua chave.

Parâmetros de consulta

integer

obrigatório

Unidades de energia a cotar. Entre 60.000 e 5.000.000.

string

padrão:"1h"

Período de aluguel. Energia aceita apenas 1h.

Cabeçalhos

string

Opcional. Com uma chave válida a resposta reflete sua tarifa negociada e sua taxa. Chave ausente, inválida ou revogada não é erro — você simplesmente recebe o preço público de mercado.

Resposta

number

Unidades de energia para as quais a cotação foi calculada

string

Período de aluguel (1h)

string

Tarifa em SUN por 1 unidade de energia. Use-a para calcular outros volumes por conta própria: aluguel = volume × price_sun / 1.000.000

string

Custo de aluguel para este volume, sem a taxa fixa

string

Taxa fixa, cobrada uma vez por pedido, independentemente do volume. Reflete a sua taxa caso haja taxa personalizada, desconto ou isenção na sua conta.

string

O que será cobrado: rental_trx + fixed_fee_trx

string | null

O mesmo total em USD. null quando a cotação TRX/USD está momentaneamente indisponível — os valores em TRX continuam válidos.

boolean

true quando sua tarifa negociada foi aplicada, false quando a cotação usa o preço público de mercado. Verifique este campo: um cabeçalho X-API-Key esquecido parece uma resposta normal, e você estaria cotando o preço público aos seus clientes enquanto é cobrado pelo seu.

Exemplo

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);

Os valores abaixo são um exemplo. A energia tem preço de mercado e ele varia ao longo do dia.

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
}

Volumes comuns

Volume	Quando
65,000	Transferência de USDT para um destinatário que já possui USDT
131,000	Transferência de USDT para um destinatário que nunca teve USDT (um novo slot de armazenamento é criado)

Não há catálogo de pacotes — qualquer volume entre 60.000 e 5.000.000 é válido, e a taxa fixa é cobrada uma vez por pedido em qualquer caso. Duas transferências para o mesmo destinatário saem mais baratas como um pedido de 131.000 do que como dois de 65.000: a taxa é paga uma vez em vez de duas.

Erros

Código	Significado
`400 INVALID_VOLUME`	Volume fora de 60.000–5.000.000
`400 INVALID_DURATION`	Duração diferente de `1h`

Uma X-API-Key inválida ou revogada não é erro aqui: a cotação é retornada ao preço público de mercado com personal_price: false.

Calcular preço

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
}

API Principal

Aluguéis de largura de banda

Pedidos

Faturas

Smart Mode

Pacotes de transferência

Conta

Webhooks

Calcular preço

Calcular preço

Parâmetros de consulta

Cabeçalhos

Resposta

Exemplo

Volumes comuns

Erros

​Calcular preço

​Parâmetros de consulta

​Cabeçalhos

​Resposta

​Exemplo

​Volumes comuns

​Erros

Calcular preço

Parâmetros de consulta

Cabeçalhos

Resposta

Exemplo

Volumes comuns

Erros