Guías de TRON

Cómo comprar energía TRON en Java con el SDK de TronSave (2026)

Por TronSave Publicado 6 min de lectura
En esta página

La forma más rápida de comprar energía TRON en Java es el SDK oficial de TronSave: agrega io.tronsave:sdk desde Maven Central, crea un cliente con tu API key, estima el costo y coloca la orden: cuatro llamadas tipadas, sin HTTP en crudo. Esta guía recorre la integración completa, desde la instalación hasta el seguimiento de una orden completada.

¿Por qué alquilar energía desde código Java?

Los servicios backend que envían USDT (TRC-20) a cualquier volumen enfrentan las mismas cuentas que todos en TRON: cada transferencia consume energía, y la energía que no tienes se paga quemando TRX a las tarifas del protocolo (consulta el modelo de recursos de TRON). Alquilar la energía justo antes de una ronda de pagos suele costar una fracción de lo que cuesta quemar TRX, y hacerlo desde código significa que tu servicio se recarga solo, sin nadie vigilando un panel. Si primero quieres la visión a nivel de API, empieza por nuestra guía de automatización con la API; este artículo es el mismo flujo, pero con tipos de Java en lugar de endpoints en crudo.

¿Qué es el SDK de TronSave para Java?

Es el cliente oficial de Java, publicado en Maven Central como io.tronsave:sdk (versión 2.0.0, para la API v2 actual y Java 17+). Junto a él hay SDK oficiales para TypeScript, Rust, Python y PHP, todos sobre los mismos endpoints, según la documentación oficial del SDK.

El cliente de Java es pequeño pero está pensado para producción: los resultados llegan como records tipados (EstimateBuyResource, Order, UserInfo), los errores forman una jerarquía de excepciones real (autenticación, validación, rate limit, red, negocio) y el cliente trae un rate limiter integrado, además de timeout y reintentos configurables en su builder.

El mercado de energía donde compra tu código al comprar energía TRON en Java con el SDK de TronSave
El SDK coloca órdenes en el mismo mercado de energía que usa la interfaz web. Fuente: TronSave

¿Cómo se instala?

Maven (pom.xml):

<dependency>
    <groupId>io.tronsave</groupId>
    <artifactId>sdk</artifactId>
    <version>2.0.0</version>
</dependency>

Gradle (build.gradle):

implementation 'io.tronsave:sdk:2.0.0'

¿Cómo obtienes una API key?

Créala en el panel de TronSave (consulta la documentación de autenticación). Con el flujo de API key, las órdenes se pagan desde tu saldo prepago en TronSave, ideal para servicios backend, porque tu clave privada de TRON nunca toca la integración. Desarrolla contra Network.TESTNET (la red de pruebas Nile, sin TRX reales) y luego cambia el enum a Network.MAINNET para salir a producción.

Cómo comprar energía TRON en Java, de principio a fin

import io.tronsave.sdk.Network;
import io.tronsave.sdk.TronsaveClient;
import io.tronsave.sdk.model.BuyResourceResult;
import io.tronsave.sdk.model.EstimateBuyResource;
import io.tronsave.sdk.model.Order;

import java.util.Map;

public class BuyEnergy {
    public static void main(String[] args) {
        TronsaveClient client = TronsaveClient.builder()
                .apiKey(System.getenv("TRONSAVE_API_KEY"))
                .network(Network.TESTNET)   // Network.MAINNET in production
                .build();

        Map<String, Object> request = Map.of(
                "receiver", "TAk6jzZqHwNUkUcbvMyAE1YAoUPk7r2T6h",
                "resourceType", "ENERGY",
                "resourceAmount", 65_000,
                "durationSec", 3_600);

        // 1. Estimate before you commit
        EstimateBuyResource estimate = client.estimateBuyResource(request);
        System.out.println("Estimated cost (TRX): " + estimate.estimateTrx());

        // 2. Place the order, paid from your TronSave balance
        BuyResourceResult result = client.buyResource(request);

        // 3. Track it until the delegation lands
        Order order = client.getOrder(result.orderId());
        System.out.println(order.status() + " — " + order.fulfilledPercent() + "% filled");
    }
}

Tres cosas a tener en cuenta. La llamada de estimación devuelve el precio unitario y la liquidez disponible además del total en TRX, así que puedes condicionar la compra al precio. La compra devuelve un orderId de inmediato; el llenado es asíncrono, así que consulta getOrder hasta que status y fulfilledPercent muestren la delegación que esperas. Y los 65.000 de energía por una hora del ejemplo están dimensionados para una sola transferencia de USDT; ajusta resourceAmount y durationSec a tu lote.

¿Qué más puede hacer el cliente?

Método Qué hace
getUserInfo() Datos de la cuenta y saldo prepago
estimateBuyResource(...) Calcula el precio de una compra antes de ordenar
buyResource(...) Compra energía o ancho de banda
getOrder(id) / getOrders(page, size) Detalle e historial de órdenes
getOrderBook(...) Lee la profundidad actual del mercado
getExtendableDelegates(...) / extendRequest(...) Lista y extiende delegaciones activas

El builder también acepta timeoutMs(...), maxRetries(...) y baseUrl(...) para ajustes finos.

¿Cómo debe manejar los errores el código de producción?

Todo lo que lanza el cliente extiende TronsaveException, pero los subtipos merecen un trato distinto. TronsaveValidationException significa que la solicitud en sí está mal (una dirección receptora mal formada, un monto incorrecto), así que reintentar no sirve de nada; regístralo y corrige la entrada. TronsaveRateLimitException significa que llamas más rápido de lo que permite tu key; espera y reintenta (el cliente además tiene un rate limiter interno que suaviza las ráfagas antes de que salgan a la red). TronsaveNetworkException cubre fallos transitorios de transporte, el caso ideal para el maxRetries del builder. Los fallos de autenticación suelen indicar una key ausente o revocada: comprueba que la variable de entorno realmente llegó al proceso.

Dos hábitos rinden especialmente en servicios de pagos: llama a getUserInfo() al arrancar y genera una alerta cuando el saldo prepago baje del costo estimado de tu próxima ronda, y trata estimateBuyResource como un circuit breaker: si el estimateTrx() cotizado supera un umbral razonable, pausa la ronda en lugar de comprar en pleno pico de precio.

Preguntas frecuentes

¿Qué versión de Java se necesita?
Java 17 o superior: los modelos del SDK son records, una característica de Java 16+, y el bytecode publicado apunta a la versión 17.

¿Puedo hacer pruebas sin gastar TRX reales?
Sí. Network.TESTNET apunta el cliente a la red de pruebas Nile, donde todo el flujo funciona igual con fondos de prueba.

¿Mi clave privada de TRON sale alguna vez de mi servidor?
Con el flujo de API key que se muestra aquí, ni siquiera interviene: las órdenes se pagan desde tu saldo prepago en TronSave. Existe un flujo aparte con clave privada si prefieres pagar directamente desde una cuenta de TRON; consulta los ejemplos de código oficiales.

¿También puedo comprar ancho de banda?
Sí, con la misma llamada buyResource y "resourceType": "BANDWIDTH".

¿Y otros lenguajes?
Hay SDK oficiales para TypeScript, Rust, Python y PHP. Tenemos guías para TypeScript, Python, PHP y Rust.

¿Tengo que usar el SDK para comprar energía TRON en Java?
No: el SDK envuelve la API HTTP v2 documentada, así que puedes llamar a los endpoints directamente con cualquier cliente HTTP. El SDK solo te ahorra la fontanería de las solicitudes, los reintentos, el rate limiting y el tipado de respuestas, que es justo el código que menos quieres mantener tú mismo en un flujo de pagos.

El SDK y la API de TronSave son operados por TronSave, editor de este blog. Prueba en Nile antes de conectar cualquier integración a fondos de mainnet.

TronSave
TronSave

El equipo de TronSave desarrolla el mercado de energía y ancho de banda de TRON en tronsave.io y escribe estas guías a partir de pruebas reales en la red principal de TRON.

Artículos relacionados

Usamos Google Analytics para saber qué guías ayudan a los lectores. Solo instala cookies si permites la analítica. El blog no muestra anuncios. Privacidad