Rentron

Documentación para desarrolladores

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

API de producción · 7 endpoints

Rentron Energy API

API de producción para cotizar, pedir y seguir alquileres de TRON Energy.

Empezar la guía rápida Autenticación

Petición rápida

// CURL

POST /v1/energy/quotes

curl https://api.rentron.xyz/v1/energy/quotes \
  -X POST \
  -H "Authorization: HMAC-SHA256 {api_key}:{base64_signature}" \
  -H "X-Request-Timestamp: 1784376000" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "TXYZ",
    "energy": 65000,
    "duration_minutes": 60
  }'

200 OK

{ "total_trx": "3.200000", "can_afford": true }

Mapa de endpoints

// 07

Fundamentos de la API

04
GET
/v1/time

Consulta la hora Unix de la API antes de firmar peticiones y diagnostica el desfase del reloj.

GET
/v1/balance

Consulta los TRX disponibles y retenidos antes de crear un pedido.

GET
/v1/energy/options

Consulta las cantidades de Energy válidas, las duraciones de alquiler y si se aceptan pedidos ahora mismo.

POST
/v1/energy/quotes

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

Pedidos de Energy

03
POST
/v1/energy/orders

Crea un alquiler de Energy idempotente y recibe su importe fijado y la URL de consulta.

GET
/v1/energy/orders/{id}

Lee un pedido propio, identifica el momento en que la Energy se puede gastar y determina si la entrega y todo el ciclo del alquiler han terminado.

GET
/v1/energy/orders?limit=20&cursor=...

Lee los pedidos del más reciente al más antiguo con paginación por cursor opaco.

Resumen

// README

Con la Rentron Energy API tu servidor alquila TRON Energy sin que nadie tenga que tocar el panel. La integración usa peticiones HTTPS normales con autenticación HMAC y consulta periódica del estado del pedido.

Resumen en un minuto

Ajuste Valor
URL base https://api.rentron.xyz/v1
Formato JSON con campos en snake_case
Autenticación HMAC-SHA256, salvo en GET /v1/time
Actualizaciones del pedido Solo consulta periódica; sin webhooks ni callbacks
Errores RFC 9457, application/problem+json
OpenAPI https://rentron.xyz/openapi/rentron-energy-v1.json

La API usa el saldo de tu cuenta de producción. No hay una API de sandbox aparte.

Flujo del pedido

  1. Consulta las opciones de alquiler actuales y pide una cotización.
  2. Crea el pedido con un client_request_id único y el total_trx exacto de la cotización como expected_total_trx.
  3. Guarda el id devuelto y la cabecera Location.
  4. Consulta GET /v1/energy/orders/{id} hasta que lifecycle_final y delivery_final sean ambos true.

Garantías del contrato

  • El servidor fija el importe final al crear el pedido y lo devuelve como total_trx.
  • Los importes son cadenas con exactamente seis decimales.
  • Repetir una petición idéntica con el mismo client_request_id no crea un duplicado.
  • Un ID inexistente y uno de otra cuenta devuelven el mismo 404.
  • La lógica de tu aplicación debe usar el code estable, nunca interpretar detail.

Sigue con la guía rápida y después centraliza la lógica de autenticación en un único cliente HTTP de servidor.