Documentación para desarrolladores

Espacio de trabajo de la API
https://api.rentron.xyz/v1
Esquema OpenAPI

Cotización

// POST

API de producción

Cotizar un pedido

Calcula el precio de alquiler actual para una dirección de TRON sin tocar el saldo de la cuenta.

POST /v1/energy/quotes
En esta página

Una cotización no reserva fondos ni garantiza un precio futuro. El importe final solo se fija al crear un pedido.

Cuerpo de la petición

{"address":"TJRabPrwbZy45sbavfcjinPJC18kjpRTv8","energy":65000,"duration_minutes":60}
Campo Tipo Obligatorio Descripción
address cadena Dirección de destino de TRON válida en Base58Check.
energy entero Cantidad divisible por energy_per_portion.
duration_minutes entero Una de las duraciones permitidas de las opciones, en minutos.

Las propiedades JSON desconocidas se rechazan.

Respuesta 200

{"address":"TJRabPrwbZy45sbavfcjinPJC18kjpRTv8","energy":65000,"duration_minutes":60,"energy_trx":"3.200000","total_trx":"3.200000","can_afford":true}
Campo Tipo Descripción
energy_trx cadena Coste del alquiler de Energy en TRX.
activation_trx cadena, ausente si no tiene valor Recargo por activar la dirección. La clave solo está cuando la dirección de destino necesita activación, y en los demás casos se omite de la respuesta: el ejemplo de arriba cotiza una dirección ya activa.
total_trx cadena Importe completo cotizado. Siempre es el valor que envías de vuelta como expected_total_trx, activación incluida.
can_afford booleano Si el saldo disponible actual es suficiente.

Todas las cadenas de importes llevan exactamente seis decimales. Los importes de arriba ilustran el formato, no una tarifa: el precio real sale de tu propia cotización.

Errores

400 significa campos o JSON no válidos, 413 un cuerpo demasiado grande, 415 un Content-Type no válido y 409 un conflicto de estado. También son posibles 401, 429, 500 y 503.