Esta página también está disponible en inglés.
TronEnergyFrog

Desarrolladores · REST y x402

API de alquiler de energía TRON

Tres llamadas alquilan energía desde tu backend: POST /v1/quotes/energy fija un precio, POST /v1/rental la alquila y GET /v1/operations/{id} confirma la entrega. Las tarifas públicas no necesitan clave. Los bots y agentes de IA sin cuenta pueden pagar cada alquiler en USDC con x402.

En esta página
  1. Para quién es
  2. API con cuenta o x402
  3. Alquilar con la API con cuenta
  4. Tarifas públicas, sin clave
  5. x402: paga en USDC
  6. Seguir la entrega
  7. Preguntas sobre la API
# 1. Fija un precio para 65.000 de energía, 1 hora
curl -X POST https://api.tronenergyfrog.com/v1/quotes/energy \
  -H "Authorization: Bearer $TEF_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"energy_amount":65000,"duration_seconds":3600,
       "target_address":"TQ5nW3…8k2Wd"}'
# → { "quote_id": "1111…", "price_trx": "…", … }

# 2. Alquílala. Los reintentos con la misma clave nunca alquilan dos veces.
curl -X POST https://api.tronenergyfrog.com/v1/rental \
  -H "Authorization: Bearer $TEF_API_KEY" \
  -H "Idempotency-Key: payout-2026-0042" \
  -H "Content-Type: application/json" \
  -d '{"quote_id":"1111…"}'
# → 202 Accepted · Location: /v1/operations/3333…

# 3. Sigue la entrega
curl https://api.tronenergyfrog.com/v1/operations/3333… \
  -H "Authorization: Bearer $TEF_API_KEY"
# → { "status": "succeeded", "txid": "…" }
Ejemplo abreviado; las direcciones y los ID son marcadores de posición.Esquemas completos en la referencia
Llamadas para alquilar energía
3Cotizar, alquilar, seguir
65K de energía, 1 hora, hoy
1,55 TRX≈ 0,47 US$ frente a 6,50 TRX quemados
Cuenta necesaria para x402
0Pago por alquiler en USDC
La cotización x402 mantiene el precio
10 minutosPrecio de la energía y tipo de cambio TRX/USD

¿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.

Exchanges y billeteras

Alquila energía para la billetera caliente antes de cada lote de retiros.

Sistemas de pagos y liquidaciones

Un alquiler idempotente por pago, con tu ID de pago como clave.

Bots y agentes de IA

Sin ninguna cuenta con x402: cotiza, paga en USDC y consulta el estado.

API con cuenta o x402: ¿cuál usar?

API con cuentax402
RegistroCuenta con clave de APINinguno: sin cuenta y sin clave de API
Pago conSaldo prepagado en TRXUSDC en Base (preferido) o Solana, por alquiler
Precio fijadoHasta el valid_until de la cotización10 minutos, precio de la energía y tipo de cambio TRX/USD
SeguimientoGET /v1/operations/{id}El status_url de la cotización
Ideal paraVolumen constante, una sola facturaAgentes, scripts puntuales, sin saldo guardado

Cómo alquilar energía TRON con la API con cuenta

  1. 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>.

  2. Fija un precio

    POST /v1/quotes/energy con energy_amount, duration_seconds (3600 o 86400) y la target_address que enviará los USDT. La respuesta incluye quote_id, price_trx, valid_until y el ahorro estimado frente a quemar TRX.

  3. Alquila con la cotización

    POST /v1/rental con el quote_id y un encabezado Idempotency-Key. Los fondos se reservan de tu saldo y el alquiler queda en cola; la respuesta es 202 con un Location hacia la operación.

  4. 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.

POST/v1/quotes/energyFijar un precio
POST/v1/rentalAlquilar energía
GET/v1/operations/{id}Seguir la entrega

Cantidades 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.

Respuesta de ejemplo · valores ilustrativos · average_commission_trx = TRX quemado sin energía
{
  "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.

  1. Lee el endpoint de capacidades

    GET /v1/x402 enumera los endpoints actuales y las redes de pago compatibles.

  2. Crea una cotización gratis

    POST /v1/x402/quotes con la target_address (y, opcionalmente, energy_amount y duration_seconds). Fija el precio de la energía y la conversión TRX/USD durante diez minutos.

  3. Obtén el desafío de pago

    Haz un POST una vez a la payment_url devuelta, sin firma. La respuesta es 402 Payment Required con PAYMENT-REQUIRED.

  4. 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 devuelve PAYMENT-RESPONSE.

  5. Consulta la URL de estado

    status_url informa tanto la liquidación del pago como la entrega de la energía.

PrioridadActivoRedUso
PreferidaUSDCBasePrimera opción para agentes compatibles
AlternativaUSDCSolanaCuando 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.

EstadoQué hacer
queued processing submittedSigue consultando. No envíes USDT todavía.
succeededLa energía está en la dirección de destino. Envía la transferencia mientras el alquiler esté activo.
failedLee error_code. No envíes USDT suponiendo que llegó la energía.
unknownEl 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.

Preguntas sobre la API

¿Aún tienes dudas? Escribe a soporte y te responderá una persona.

¿Necesito una cuenta para usar la API de energía TRON?

Para la API con cuenta, sí: crea una clave de API en tu cuenta. El endpoint público de tarifas y los endpoints de x402 no necesitan cuenta ni clave de API.

¿Cómo se pagan los alquileres por API?

Los alquileres de la API con cuenta se pagan con el saldo prepagado de tu cuenta. Los alquileres x402 se pagan uno a uno en USDC, en Base (preferido) o Solana.

¿Cómo evito pagar dos veces cuando se reintenta una solicitud?

Envía un encabezado Idempotency-Key con POST /v1/rental. Repetir la solicitud con la misma clave no crea un segundo alquiler.

¿Qué opción de pago x402 debe elegir un bot?

USDC en Base cuando esté disponible, y USDC en Solana como alternativa. La respuesta 402 es la fuente de verdad para las redes, las direcciones de tokens, los destinatarios, el vencimiento y el importe exacto.

¿Dónde están los esquemas completos de solicitudes y respuestas?

En la referencia de la API, también disponible como OpenAPI JSON y Markdown.

Sobre esta página

Los endpoints y los nombres de campos coinciden con la referencia publicada de la API. El código está abreviado para facilitar la lectura; la referencia tiene los esquemas y errores completos.

Referencia
api.tronenergyfrog.com/v1/docsLas versiones OpenAPI JSON y Markdown están enlazadas allí
Precios
API pública de tarifas, 22 nov 2026, 12:38 UTC
x402
Flujo de pago x402, USDC en Base y Solana
Revisado
17 nov 2026 · equipo de TronEnergyFrog

Alquila tus próximos 65K por 1,55 TRX en lugar de quemar 6,50 TRX

Prueba primero un alquiler en el sitio web y luego automatízalo. No necesitas cuenta para un alquiler como invitado, y no se cobra nada hasta que pagues.

Tu próxima transferencia

Energía necesaria
65.000
Quema sin energía
6,50 TRX ≈ 1,98 US$
Con TronEnergyFrog
1,55 TRX ≈ 0,47 US$
Te ahorras
4,95 TRX ≈ 1,51 US$
65K de energía, 1 hora1,55 TRX ≈ 0,47 US$
Alquilar energía