¿Para quién es la API de energía TRON?
Para cualquiera que envíe USDT en TRON desde código con la frecuencia suficiente como para que 6,50 TRX quemados por transferencia se noten.
Alquila energía para la billetera caliente antes de cada lote de retiros.
Un alquiler idempotente por pago, con tu ID de pago como clave.
Sin ninguna cuenta con x402: cotiza, paga en USDC y consulta el estado.
API con cuenta o x402: ¿cuál usar?
| API con cuenta | x402 | |
|---|---|---|
| Registro | Cuenta con clave de API | Ninguno: sin cuenta y sin clave de API |
| Pago con | Saldo prepagado en TRX | USDC en Base (preferido) o Solana, por alquiler |
| Precio fijado | Hasta el valid_until de la cotización | 10 minutos, precio de la energía y tipo de cambio TRX/USD |
| Seguimiento | GET /v1/operations/{id} | El status_url de la cotización |
| Ideal para | Volumen constante, una sola factura | Agentes, scripts puntuales, sin saldo guardado |
Cómo alquilar energía TRON con la API con cuenta
- Crea una clave de API
Inicia sesión con Telegram o Google, abre API y crea una clave. El valor completo se muestra solo una vez. Envíala como
Authorization: Bearer <key>. - Fija un precio
POST /v1/quotes/energyconenergy_amount,duration_seconds(3600 o 86400) y latarget_addressque enviará los USDT. La respuesta incluyequote_id,price_trx,valid_untily el ahorro estimado frente a quemar TRX. - Alquila con la cotización
POST /v1/rentalcon elquote_idy un encabezadoIdempotency-Key. Los fondos se reservan de tu saldo y el alquiler queda en cola; la respuesta es202con unLocationhacia la operación. - Espera la entrega y luego envía USDT
Consulta la operación hasta que se complete y luego firma la transferencia desde la dirección de destino.
/v1/quotes/energyFijar un precio/v1/rentalAlquilar energía/v1/operations/{id}Seguir la entregaCantidades personalizadasDefine custom_amount como true para cantidades distintas de 65.000 o 130.000. La API publica el mínimo actual; la referencia explica dónde consultarlo.
Consulta los precios de la energía TRON sin clave
GET https://tronenergyfrog.com/api/v1/rates/energy/default devuelve el precio público de 65.000 de energía por 1 hora, el TRX que quemaría esa misma energía, el ahorro y el historial por hora. Agrega ?history=1d, 7d, 30d o 90d. Las respuestas se guardan en caché durante 30 segundos.
{
"energy_amount": 65000,
"duration_seconds": 3600,
"price_trx": "2.05",
"average_commission_trx": "6.5",
"savings_trx": "4.45",
"savings_percent": "68.46",
"network_fee_updated_at": "2026-11-17T12:00:00Z",
"price_history": {
"window_hours": 168,
"median_price_trx": "1.59",
"current_vs_median_percent": "28.9",
"points": [ … ]
}
}Úsalo para paneles y alertas de precio. Para un pedido, solicita siempre una cotización: la tarifa pública es una referencia, no un precio fijado.
x402: alquila energía TRON con USDC, sin cuenta
No se necesita registro, cuenta, clave de API ni saldo prepagado. Descubre el contrato vigente en GET /v1/x402 y luego sigue el flujo estándar de x402. Los esquemas de cada campo están en la sección x402 de la referencia de la API.
- Lee el endpoint de capacidades
GET /v1/x402enumera los endpoints actuales y las redes de pago compatibles. - Crea una cotización gratis
POST /v1/x402/quotescon latarget_address(y, opcionalmente,energy_amountyduration_seconds). Fija el precio de la energía y la conversión TRX/USD durante diez minutos. - Obtén el desafío de pago
Haz un POST una vez a la
payment_urldevuelta, sin firma. La respuesta es402 Payment RequiredconPAYMENT-REQUIRED. - Paga y reintenta
Paga una de las opciones anunciadas desde la billetera del agente y reintenta la misma URL con
PAYMENT-SIGNATURE. Una liquidación correcta devuelvePAYMENT-RESPONSE. - Consulta la URL de estado
status_urlinforma tanto la liquidación del pago como la entrega de la energía.
| Prioridad | Activo | Red | Uso |
|---|---|---|---|
| Preferida | USDC | Base | Primera opción para agentes compatibles |
| Alternativa | USDC | Solana | Cuando el agente tiene fondos en Solana |
La respuesta 402 es la fuente de verdadpara los identificadores de red, las direcciones de tokens, los destinatarios, el vencimiento y el importe atómico exacto. Los bots deben leer las respuestas de la API en lugar de extraer los precios de esta página.
¿Cómo sé que se entregó la energía?
Cada alquiler es una operación. Consulta GET /v1/operations/{id} hasta que llegue a un estado final; una operación completada incluye el txid de la delegación, que puedes abrir en TronScan.
| Estado | Qué hacer |
|---|---|
| queued processing submitted | Sigue consultando. No envíes USDT todavía. |
| succeeded | La energía está en la dirección de destino. Envía la transferencia mientras el alquiler esté activo. |
| failed | Lee error_code. No envíes USDT suponiendo que llegó la energía. |
| unknown | El resultado todavía no está confirmado. Sigue consultando; consulta la referencia para saber cómo manejarlo. |
Los endpoints de historial y los ID de proyecto para relacionar operaciones con tus propios pedidos se describen en la referencia de la API.