Calcular precio

GET

api

energy

quote

Calcular precio

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
}

Devuelve el importe exacto que se cobrará por un volumen de energía dado — alquiler y comisión fija juntos, a su tarifa. Este endpoint es público — la autenticación es opcional. Envíe su clave API para recibir su propio precio; sin ella obtendrá el precio público de mercado.

Use este endpoint cuando necesite el precio de un volumen concreto. GET /api/v1/prices siempre cotiza 65 000 unidades y no acepta parámetros, y POST /api/v1/energy/estimate devuelve solo el alquiler a precio de mercado, ignorando su clave.

Parámetros de consulta

integer

requerido

Unidades de energía a cotizar. Entre 60 000 y 5 000 000.

string

predeterminado:"1h"

Periodo de alquiler. La energía solo admite 1h.

Cabeceras

string

Opcional. Con una clave válida la respuesta refleja su tarifa negociada y su comisión. Una clave ausente, inválida o revocada no es un error: simplemente obtendrá el precio público de mercado.

Respuesta

number

Unidades de energía para las que se calculó la cotización

string

Periodo de alquiler (1h)

string

Tarifa en SUN por 1 unidad de energía. Úsela para calcular otros volúmenes usted mismo: alquiler = volumen × price_sun / 1 000 000

string

Coste de alquiler para este volumen, sin la comisión fija

string

Comisión fija, cobrada una vez por pedido sin importar el volumen. Refleja su propia comisión si a su cuenta se le aplica una comisión personalizada, un descuento o una exención.

string

Lo que se le cobrará: rental_trx + fixed_fee_trx

string | null

El mismo total en USD. null cuando la tasa TRX/USD no está disponible momentáneamente — las cifras en TRX siguen siendo válidas.

boolean

true cuando se aplicó su tarifa negociada, false cuando la cotización va al precio público de mercado. Compruébelo: una cabecera X-API-Key olvidada parece una respuesta normal, y estaría cotizando a sus clientes el precio público mientras se le cobra el suyo.

Ejemplo

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

Los valores siguientes son un ejemplo. La energía tiene precio de mercado y se mueve durante el día.

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
}

Volúmenes habituales

Volumen	Cuándo
65,000	Transferencia USDT a un destinatario que ya posee USDT
131,000	Transferencia USDT a un destinatario que nunca ha tenido USDT (se crea un nuevo slot de almacenamiento)

No hay catálogo de paquetes — cualquier volumen entre 60 000 y 5 000 000 es válido, y la comisión fija se cobra una vez por pedido en cualquier caso. Dos transferencias al mismo destinatario salen más baratas como un pedido de 131 000 que como dos de 65 000: la comisión se paga una vez en lugar de dos.

Errores

Código	Significado
`400 INVALID_VOLUME`	Volumen fuera de 60 000–5 000 000
`400 INVALID_DURATION`	Duración distinta de `1h`

Una X-API-Key inválida o revocada no es un error aquí: la cotización se devuelve al precio público de mercado con personal_price: false.

Calcular precio

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

Alquileres de ancho de banda

Órdenes

Facturas

Smart Mode

Paquetes de transferencia

Cuenta

Webhooks

Calcular precio

Calcular precio

Parámetros de consulta

Cabeceras

Respuesta

Ejemplo

Volúmenes habituales

Errores

​Calcular precio

​Parámetros de consulta

​Cabeceras

​Respuesta

​Ejemplo

​Volúmenes habituales

​Errores

Calcular precio

Parámetros de consulta

Cabeceras

Respuesta

Ejemplo

Volúmenes habituales

Errores