Alquiler de energía TRON por API: cómo automatizar pedidos de energía para pagos en USDT

Cómo funciona el alquiler de energía TRON por API: consulta de precio, creación de pedidos, token y lista blanca de IP, y errores habituales para casas de cambio y servicios de pagos en USDT.

Overtron Editorial

En breve: alquilar energía TRON por API significa que tu propio servicio pide el precio, encarga energía para una dirección concreta y comprueba el estado del pedido con peticiones HTTP normales, sin que nadie pulse botones en un bot. Para una casa de cambio, una pasarela de pagos o un bot de pagos masivos es la forma de dejar de quemar TRX en cada transferencia de USDT sin tener a un operador de guardia.

Núcleo de energía esmeralda brillante conectado con cables a un rack de servidor y a una ventana de terminal: alquiler de energía TRON por API
Alquiler de energía TRON por API: pedir energía desde el código de tu servicio

Para qué sirve una API de alquiler de energía TRON

Una transferencia de USDT TRC-20 a una dirección que ya tiene USDT consume aproximadamente 64 500-65 000 de energía. Si el remitente no tiene energía, la red quema en su lugar unos 6,5 TRX, y en una transferencia a una dirección vacía la cifra se duplica (unos 13 TRX). Con pocas transferencias al día es tolerable. Con cientos, comprar energía a mano se vuelve un cuello de botella: alguien tiene que pedirla antes de la transferencia, no después.

La API saca a la persona del proceso. Antes de un pago, tu servicio consulta el precio, crea un pedido para la dirección remitente y solo entonces firma la transferencia. Abajo verás cómo funciona en Overtron, qué peticiones necesitas y dónde suelen fallar las integraciones.

A quién le sirve el alquiler de energía TRON por API

  • casas de cambio y servicios P2P que envían USDT a clientes de forma automática;
  • pasarelas de pago y procesadores que pagan por lotes;
  • bots y plataformas de pagos (afiliación, bolsas freelance, GameFi);
  • equipos de trading con varias billeteras que necesitan un coste por transferencia predecible.

Si envías USDT solo de vez en cuando, no necesitas API: basta un pedido puntual en el sitio o en el bot con comprar energía TRON. Más artículos sobre el tema están en el blog de Overtron.

Cómo funciona el alquiler de energía TRON por API

El esquema tiene tres pasos. La energía no se «envía» a tu dirección como un token: se delega, es decir, el proveedor te permite usar parte de los recursos de la red desde su stake durante un plazo fijado.

  • Consulta de precio. Indicas la cantidad de energía y el plazo y recibes una cotización. Es solo lectura: no cobra nada ni crea nada.
  • Creación del pedido. Indicas la dirección que recibirá la energía, la cantidad y el plazo. La respuesta incluye el ID del pedido y un estado de procesamiento.
  • Transferencia de USDT. Cuando la energía ya está delegada a la dirección, envías la transferencia sin quemar TRX.

Las claves privadas no participan en este esquema: el pedido solo necesita la dirección pública de quien recibe la energía. Más sobre por qué nunca hacen falta las claves en el artículo sobre alquilar energía sin claves privadas (en el blog).

Peticiones de la API de energía TRON que necesitarás

La Partner API de Overtron es pequeña. Para el caso típico de pedir energía antes de un pago bastan dos métodos; el resto son extras cómodos.

Precio antes del pedido

El método de cotización recibe una cantidad de energía y un plazo. Para una transferencia normal de USDT a una dirección que ya tiene el token se suelen pedir unos 65 000 de energía. Para una dirección vacía, cuenta con aproximadamente el doble. No guardes el precio en caché mucho tiempo: el coste de la energía sigue al mercado y un valor de hace una hora puede no coincidir ya con el actual.

Creación del pedido

El pedido se crea con la dirección que recibe la energía, la cantidad, el plazo y el identificador de tu usuario en el sistema. La respuesta devuelve el ID del pedido y un estado que, al crearse, normalmente indica que está en procesamiento. La delegación lleva tiempo de red: un bloque de TRON dura 3 segundos, pero el proveedor debe confirmar la operación, así que vigila el estado en lugar de suponer una ejecución instantánea.

Métodos auxiliares

  • saldo e historial de operaciones del usuario, para conciliar gastos;
  • último pedido del usuario, útil para comprobar el resultado tras un fallo;
  • dirección de depósito para recargar el saldo con el que se pagan los pedidos;
  • lista de IP permitidas para la clave, que vemos en la sección siguiente.

La especificación completa en Swagger (OpenAPI) y el token los entregamos tras una solicitud en la página de alquiler de energía TRON por API, donde también hay un ejemplo de petición y respuesta.

Seguridad de la integración: token, IP y trazabilidad

La Partner API está protegida con un token que se envía en la cabecera Authorization como Bearer o en X-API-Key. Un token incorrecto o ausente devuelve 403, y es el error más habitual en el primer arranque: el token se puso en el cuerpo de la petición o se olvidó la palabra Bearer.

  • Lista blanca de IP. Las peticiones de un usuario pueden limitarse a ciertas direcciones o subredes (IPv4, IPv6, CIDR). Con la lista vacía la restricción está desactivada; con la lista rellena se rechazan las peticiones desde otras IP. Actívala siempre en producción.
  • ID de petición. Envía tu propia cabecera X-Request-ID: si no, el servicio genera una y la devuelve. Así es fácil localizar en los logs un pedido discutido.
  • Límites de frecuencia. Las peticiones que crean algo tienen límite. Al superarlo, el servicio responde 429 con la cabecera Retry-After: espera ese tiempo en lugar de insistir con reintentos.

Guarda el token solo en el servidor: no en una app móvil, ni en código de navegador, ni en un repositorio público. Si se filtra, hay que reemitirlo, así que escríbenos. Sobre la diferencia entre un esquema honesto y uno peligroso, mira el blog.

Cuánta energía pedir y por cuánto tiempo

El tamaño del pedido depende del escenario. Una transferencia normal de USDT necesita unos 65 000 de energía; a una dirección nueva sin USDT, aproximadamente el doble. Si haces varias transferencias seguidas desde una dirección, súmalas y pide una sola vez.

Elige el plazo según el ritmo de tus pagos. Si las transferencias salen cada pocos minutos, plazos muy cortos con pedidos frecuentes pueden resultar incómodos, y tiene más sentido un periodo más largo o la recarga automática. Una buena comprobación: cuántas operaciones harás dentro del plazo y si parte de la energía quedará sin usar.

Errores habituales de integración

  • Pedir tras la transferencia. Si envías USDT primero y pides energía después, la red ya habrá quemado TRX. El orden es estricto: pedido, comprobar estado, transferencia.
  • Reintento a ciegas tras un timeout. La petición de crear pedido pudo llegar aunque se perdiera la respuesta. Antes de repetir el POST, consulta el último pedido del usuario y guarda el ID del pedido en tu lado.
  • Un solo pedido para muchas direcciones. La energía se delega a una dirección concreta. Si los pagos salen de varias direcciones, pide para cada una.
  • Sin margen para una dirección vacía. Un destinatario nuevo necesita aproximadamente el doble de energía. Subestimarlo acaba en un fallo por falta de energía (OUT_OF_ENERGY), que no significa dinero perdido.
  • Token en código de cliente. Cualquiera que lo vea podrá pedir energía en tu nombre.

Cómo es un flujo de pago que funciona

  • Antes del pago, el servicio comprueba si el destinatario ya tiene USDT y elige la cantidad de energía.
  • Consulta el precio y, si encaja en tu límite de coste, crea un pedido para la dirección remitente.
  • Espera a que el estado del pedido indique que la energía está delegada.
  • Envía la transferencia de USDT TRC-20 y guarda el hash de la transacción junto con el ID del pedido.
  • Al final del día concilia el historial de operaciones con tu contabilidad.

Este ciclo se encapsula fácilmente en una cola de tareas: un proceso pide energía y otro envía transferencias. Así, una caída temporal de cualquiera de las partes no quema TRX; la transferencia simplemente espera su turno.

Qué conviene recordar

La entrega depende del estado de la red y de los proveedores, así que incluye en tu código esperas y comprobaciones repetidas del estado en lugar de suponer que todo se ejecuta de inmediato. En este artículo no damos tarifas: varían con el mercado y la cotización actual la obtienes con la consulta de precio en el momento del pedido.

¿Quieres conectar la API? Deja una solicitud en la página de alquiler de energía TRON por API, o prueba primero un pedido puntual con alquiler de energía TRON para ver el proceso completo. El estado de la red está en la página de estado.

¿Quieres hablar de una integración para tu flujo de transferencias? Escríbenos por Telegram: @overtronbot.

Lee también

FAQ

¿Qué es el alquiler de energía TRON por API?

Es pedir energía mediante una petición programática: tu servicio obtiene el precio, crea un pedido para la dirección adecuada y comprueba su estado sin acciones manuales en un bot. La energía se delega a la dirección durante el plazo elegido.

¿Cómo conecto la API de alquiler de energía TRON?

Deja una solicitud en la página /es/api. Tras la aprobación recibes un token y un enlace a la documentación en Swagger. El token se envía en la cabecera Authorization (Bearer) o en X-API-Key.

¿Necesito claves privadas para pedir energía por API?

No. El pedido solo necesita la dirección pública que recibe la energía. Las claves privadas y la frase semilla no forman parte de la integración y nunca deben compartirse.

¿Cuánta energía debo pedir para una transferencia de USDT?

Una transferencia normal a una dirección que ya tiene USDT necesita aproximadamente 64 500-65 000 de energía. A una dirección vacía, aproximadamente el doble, unos 131 000.

¿Qué pasa si pido la energía después de la transferencia?

La red ya habrá quemado TRX por la transferencia: unos 6,5 TRX sin energía y unos 13 TRX a una dirección vacía. Crea el pedido y espera su estado antes de enviar la transferencia.

¿Cómo protejo mi clave de API?

Guárdala solo en el servidor, activa la lista blanca de IP (IPv4, IPv6, CIDR), envía X-Request-ID para el rastreo y no publiques el token en código de cliente ni en repositorios.

¿Qué significan los errores 403 y 429?

403 se devuelve con un token incorrecto o ausente, o con una petición desde una IP fuera de la lista blanca. 429 indica que superaste la frecuencia de peticiones: espera el tiempo de la cabecera Retry-After.

¿Sirve la API para transferencias puntuales?

Para transferencias ocasionales es más sencillo pedir la energía a mano en el sitio o en el bot. La API compensa cuando hay muchas transferencias que deben ejecutarse de forma automática.

¿Se garantiza la ejecución instantánea del pedido?

No. La delegación depende del estado de la red y de los proveedores, así que comprueba el estado del pedido e incluye esperas en tu código en lugar de suponer ejecución instantánea.