API de TronRental para principiantes: compra energía TRON en 7 pasos
Guía paso a paso para desarrolladores sin experiencia en TRON. Desde el registro hasta tu primera compra de energía por API.
¿Para quién es esta guía?
Esta guía es para desarrolladores, creadores de bots y propietarios de negocios que quieren automatizar la compra de energía y ancho de banda TRON. No se requiere experiencia previa con TRON.
Al final de esta guía podrás consultar precios, comprar energía y ancho de banda, y verificar el estado de pedidos — todo desde tu propio código.
¿Qué puedes construir con la API?
Un bot que compra energía automáticamente antes de cada transferencia USDT
Integración en tu propio exchange, wallet o servicio de pagos
Compras masivas de energía para múltiples direcciones a la vez
¿Qué es una API y por qué usarla?
API (Interfaz de Programación de Aplicaciones) es una forma de controlar un servicio desde código en lugar de hacer clic en botones en un sitio web. Piensa en ella como un control remoto para TronRental.
Con la API de TronRental puedes hacer todo lo que hace el sitio web — consultar precios, comprar energía, comprar ancho de banda — pero automáticamente, desde un script o servidor.
Manual vs API
Manual: abrir el sitio, iniciar sesión, ingresar dirección, elegir volumen, hacer clic en comprar, esperar, repetir
API: una solicitud HTTP → la energía se delega en segundos. Sin necesidad de navegador.
Paso 1 — Registro e inicio de sesión
Ve a tronrental.com y crea una cuenta. Puedes registrarte con email, Google, Telegram o una wallet TronLink.
Después del registro, ve a tu Dashboard. Aquí gestionas todo: saldo, pedidos, claves API y configuración.
Paso 2 — Crear una clave API
En el Dashboard, ve a la sección API y haz clic en "Create API Key".
Importante: la clave API se muestra solo una vez. Cópiala y guárdala en un lugar seguro. Si la pierdes, tendrás que crear una nueva.
Una clave API es como una contraseña para tu script. Le dice a TronRental quién hace la solicitud y cobra de tu saldo.
Opcional: puedes restringir la clave a direcciones IP específicas para mayor seguridad.
Opcional: configura una URL de Webhook para recibir notificaciones automáticas cuando cambie el estado del pedido.
Paso 3 — Depositar fondos
Ve a Dashboard → Deposit y copia tu dirección de depósito personal.
Envía TRX o USDT (TRC-20) a esta dirección. El depósito se confirma normalmente en 30 segundos.
Puedes verificar tu saldo por API:
curl -X GET https://tronrental.com/api/v1/account/balance \
-H "Authorization: Bearer YOUR_API_KEY"# Python
import requests
API_KEY = "YOUR_API_KEY"
headers = {"Authorization": f"Bearer {API_KEY}"}
r = requests.get("https://tronrental.com/api/v1/account/balance", headers=headers)
print(r.json())// JavaScript (Node.js)
const API_KEY = "YOUR_API_KEY";
const res = await fetch("https://tronrental.com/api/v1/account/balance", {
headers: { "Authorization": `Bearer ${API_KEY}` }
});
console.log(await res.json());Respuesta:
{
"balance_trx": "150.50",
"balance_usdt": "0.00",
"deposit_address": "TYour1Deposit2Address3Here..."
}Paso 4 — Consultar precios actuales
Antes de comprar, consulta los precios actuales. Este endpoint es público — no se requiere clave API.
curl -X GET https://tronrental.com/api/v1/prices# Python
import requests
r = requests.get("https://tronrental.com/api/v1/prices")
print(r.json())// JavaScript
const res = await fetch("https://tronrental.com/api/v1/prices");
console.log(await res.json());Respuesta:
{
"energy": {
"1h": "0.84",
"1d": "4.20"
},
"bandwidth": {
"1d": "9.60"
},
"burn_cost_trx": "6.43",
"savings_percent": "87"
}Campos de la respuesta:
- energy.1h — precio por 1.000 unidades de energía por 1 hora (en TRX)
- bandwidth — precio por 1.000 unidades de ancho de banda por 1 día (en TRX)
- burn_cost_trx — cuántos TRX quemarías sin energía
- savings_percent — cuánto ahorras alquilando vs quemando
Fórmula del precio: price_per_1k × (volumen / 1000). Por ejemplo, si energy.1h es 0.84 TRX y necesitas 65,000 energía: 0.84 × 65 = 54.6 TRX.
Paso 5 — Comprar energía
Ahora la parte principal — comprar energía. Envía una solicitud POST con la dirección destino, volumen y duración.
Parámetros:
target_address— la dirección TRON que recibirá la energíavolume— cantidad de energía (mín 32,000, máx 5,000,000)duration— período de alquiler: "1h" (1 hora) o "1d" (1 día)
¿Cuánta energía necesitas? Para una transferencia USDT: 65,000 si el destinatario ya tiene USDT, o 131,000 si no.
Solicitud:
curl -X POST https://tronrental.com/api/v1/energy/buy \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"target_address": "TReceiverAddress...",
"volume": 65000,
"duration": "1h"
}'# Python
import requests
API_KEY = "YOUR_API_KEY"
headers = {
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json"
}
data = {
"target_address": "TReceiverAddress...",
"volume": 65000,
"duration": "1h"
}
r = requests.post("https://tronrental.com/api/v1/energy/buy",
headers=headers, json=data)
print(r.json())// JavaScript (Node.js)
const API_KEY = "YOUR_API_KEY";
const res = await fetch("https://tronrental.com/api/v1/energy/buy", {
method: "POST",
headers: {
"Authorization": `Bearer ${API_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
target_address: "TReceiverAddress...",
volume: 65000,
duration: "1h"
})
});
console.log(await res.json());Respuesta:
{
"id": 1234,
"type": "energy",
"target_address": "TReceiverAddress...",
"volume": 65000,
"duration": "1h",
"price_trx": "54.60",
"status": "pending",
"created_at": "2026-02-28T12:00:00Z"
}Estados del pedido:
- pending — pedido creado, esperando procesamiento
- delegated — energía delegada a la dirección destino
- completed — período de alquiler finalizado, energía recuperada
Paso 6 — Comprar ancho de banda
El ancho de banda funciona igual que la energía. Se requiere para cualquier transacción TRON (no solo USDT).
Parámetros:
target_address— la dirección TRON que recibirá el ancho de bandavolume— cantidad de ancho de banda (mín 350, máx 100,000)duration— período de alquiler: "1h"
Se agrega una tarifa fija de 0.2 TRX a cada pedido de ancho de banda.
Solicitud:
curl -X POST https://tronrental.com/api/v1/bandwidth/buy \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"target_address": "TReceiverAddress...",
"volume": 5000,
"duration": "1h"
}'# Python
import requests
API_KEY = "YOUR_API_KEY"
headers = {
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json"
}
data = {
"target_address": "TReceiverAddress...",
"volume": 5000,
"duration": "1h"
}
r = requests.post("https://tronrental.com/api/v1/bandwidth/buy",
headers=headers, json=data)
print(r.json())// JavaScript (Node.js)
const API_KEY = "YOUR_API_KEY";
const res = await fetch("https://tronrental.com/api/v1/bandwidth/buy", {
method: "POST",
headers: {
"Authorization": `Bearer ${API_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
target_address: "TReceiverAddress...",
volume: 5000,
duration: "1h"
})
});
console.log(await res.json());Respuesta:
{
"id": 1235,
"type": "bandwidth",
"target_address": "TReceiverAddress...",
"volume": 5000,
"duration": "1h",
"price_trx": "2.20",
"status": "pending",
"created_at": "2026-02-28T12:05:00Z"
}Paso 7 — Verificar estado del pedido
Después de hacer un pedido, puedes verificar su estado en cualquier momento.
Obtener todos los pedidos:
curl -X GET https://tronrental.com/api/v1/orders \
-H "Authorization: Bearer YOUR_API_KEY"Obtener un pedido específico por ID:
curl -X GET https://tronrental.com/api/v1/orders/1234 \
-H "Authorization: Bearer YOUR_API_KEY"# Python
import requests
API_KEY = "YOUR_API_KEY"
headers = {"Authorization": f"Bearer {API_KEY}"}
# All orders
orders = requests.get("https://tronrental.com/api/v1/orders",
headers=headers).json()
# Single order
order = requests.get("https://tronrental.com/api/v1/orders/1234",
headers=headers).json()
print(order["status"]) # "delegated"Respuesta:
{
"id": 1234,
"type": "energy",
"target_address": "TReceiverAddress...",
"volume": 65000,
"duration": "1h",
"price_trx": "54.60",
"status": "delegated",
"delegate_txid": "abc123def456...",
"created_at": "2026-02-28T12:00:00Z",
"delegated_at": "2026-02-28T12:00:04Z"
}Busca el campo "status". Cuando dice "delegated", la energía o ancho de banda ha sido entregada exitosamente. El campo "delegate_txid" contiene el hash de la transacción.
Mejores prácticas y consejos
Seguridad
Nunca escribas tu clave API directamente en el código. Usa variables de entorno:
Python:
import os
API_KEY = os.environ["TRONRENTAL_API_KEY"]JavaScript/Node.js:
const API_KEY = process.env.TRONRENTAL_API_KEY;Lista blanca de IP
Para producción, siempre configura una lista blanca de IP en tu clave API. Así, incluso si la clave se filtra, no puede usarse desde otro servidor.
Límites de velocidad
La API permite 30 solicitudes por 60 segundos por clave. Si excedes esto, recibirás una respuesta 429. Agrega un pequeño retraso entre solicitudes.
Errores comunes
Los códigos de error más comunes y qué hacer:
401 Unauthorized — clave API inválida o faltante. Verifica el header Authorization.
400 Bad Request — parámetros inválidos. Revisa el mensaje de error en la respuesta.
402 Payment Required — saldo insuficiente. Deposita más TRX.
429 Too Many Requests — límite excedido. Espera y reintenta.
Webhooks
En lugar de consultar el estado constantemente, configura una URL de webhook. TronRental enviará una solicitud POST cuando el estado cambie.
El payload del webhook incluye el objeto de pedido completo con el estado actualizado.
Preguntas frecuentes
¿Cuánta energía necesito para una transferencia USDT?
65,000 energía si el destinatario ya tiene USDT, o 131,000 si no. Usa nuestra Calculadora de Energía para verificar cualquier dirección.
¿Qué tan rápido se delega la energía?
Normalmente en 3-5 segundos después de hacer el pedido.
¿Qué pasa si mi saldo se agota?
La API devolverá un error 402. Los pedidos existentes permanecen activos. Simplemente deposita más TRX y continúa.
¿Puedo comprar energía para la dirección de otra persona?
Sí. target_address puede ser cualquier dirección TRON válida. No necesitas ser el propietario.
¿Qué lenguajes de programación son compatibles?
Cualquier lenguaje que pueda hacer solicitudes HTTP. Mostramos ejemplos en Python, JavaScript y curl, pero puedes usar Go, PHP, Java, Rust o cualquier otro.