O jeito mais rápido de comprar energia TRON em Java é o SDK oficial da TronSave: adicione io.tronsave:sdk a partir do Maven Central, crie um cliente com a sua chave de API, estime o custo e faça o pedido. São quatro chamadas tipadas, sem HTTP cru. Este guia percorre a integração inteira, da instalação até o acompanhamento de um pedido preenchido.
Por que alugar energia a partir de código Java?
Serviços de backend que enviam USDT (TRC-20) em qualquer volume esbarram na mesma conta que todo mundo na TRON: cada transferência consome energia, e a energia que você não tem é paga queimando TRX pelas tarifas do protocolo (veja o modelo de recursos da TRON). Alugar a energia na hora certa, logo antes de um lote de pagamentos, normalmente custa uma fração do que se queimaria, e fazer isso pelo código significa que o serviço se recarrega sozinho, sem ninguém de olho num painel. Se quiser ver primeiro o nível da API, comece pelo nosso guia de automação com a API; este post mostra o mesmo fluxo com tipos Java em vez de endpoints crus.
O que é o SDK da TronSave para Java?
É o cliente oficial em Java, publicado no Maven Central como io.tronsave:sdk (versão 2.0.0, voltado para a API v2 atual e para Java 17+). Ao lado dele existem SDKs oficiais para TypeScript, Rust, Python e PHP, todos encapsulando os mesmos endpoints, segundo a documentação oficial dos SDKs.
O cliente Java é pequeno, mas pensado para produção: os resultados voltam como records tipados (EstimateBuyResource, Order, UserInfo), os erros formam uma hierarquia real de exceções (autenticação, validação, rate limit, rede, negócio) e o cliente traz um rate limiter embutido, além de timeout e retries configuráveis no builder.

Como instalar?
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'
Como obter uma chave de API?
Crie uma no painel da TronSave (veja a documentação de autenticação). No fluxo com chave de API, os pedidos são pagos com o seu saldo pré-pago na TronSave, o que é ideal para serviços de backend, já que a chave privada da sua conta TRON nunca passa pela integração. Desenvolva usando Network.TESTNET (a rede de testes Nile, sem TRX real) e depois troque o enum para Network.MAINNET para entrar em produção.
Como comprar energia TRON em Java, do início ao fim
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");
}
}
Três pontos merecem atenção. A chamada de estimativa retorna o preço unitário e a liquidez disponível, além do total em TRX, então você pode condicionar a compra ao preço. A compra retorna um orderId na hora; o preenchimento é assíncrono, então consulte getOrder até que status e fulfilledPercent mostrem a delegação esperada. E os 65.000 de energia por uma hora do exemplo são dimensionados para uma única transferência de USDT; ajuste resourceAmount e durationSec ao seu lote.
O que mais o cliente faz?
| Método | O que faz |
|---|---|
getUserInfo() |
Dados da conta e saldo pré-pago |
estimateBuyResource(...) |
Calcula o preço de uma compra antes do pedido |
buyResource(...) |
Compra energia ou largura de banda |
getOrder(id) / getOrders(page, size) |
Detalhe e histórico de pedidos |
getOrderBook(...) |
Lê a profundidade atual do mercado |
getExtendableDelegates(...) / extendRequest(...) |
Lista e estende delegações ativas |
O builder também aceita timeoutMs(...), maxRetries(...) e baseUrl(...) para ajustes finos.
Como o código de produção deve tratar erros?
Tudo o que o cliente lança estende TronsaveException, mas os subtipos merecem tratamentos diferentes. TronsaveValidationException significa que a própria requisição está errada (um endereço de destino malformado, um valor inválido), então tentar de novo não adianta; registre no log e corrija a entrada. TronsaveRateLimitException significa que você está chamando mais rápido do que a sua chave permite; espere um pouco e tente de novo (o cliente também tem um rate limiter interno que suaviza picos antes de chegarem à rede). TronsaveNetworkException cobre falhas de transporte passageiras, o caso natural para o maxRetries do builder. Falhas de autenticação geralmente indicam uma chave ausente ou revogada; confira se a variável de ambiente realmente chegou ao processo.
Dois hábitos valem a pena especialmente em serviços de pagamento: chame getUserInfo() na inicialização e dispare um alerta quando o saldo pré-pago ficar abaixo do custo estimado da próxima execução, e use estimateBuyResource como disjuntor: se o estimateTrx() cotado passar de um limite razoável, segure a execução em vez de comprar no meio de um pico de preço.
Perguntas frequentes
Qual versão do Java é necessária?
Java 17 ou mais recente: os modelos do SDK são records, um recurso do Java 16+, e o bytecode publicado tem como alvo o 17.
Posso testar sem gastar TRX real?
Sim. Network.TESTNET aponta o cliente para a rede de testes Nile, onde todo o fluxo funciona da mesma forma com fundos de teste.
A chave privada da minha conta TRON sai do meu servidor em algum momento?
No fluxo com chave de API mostrado aqui, ela nem participa: os pedidos são pagos com o seu saldo pré-pago na TronSave. Existe um fluxo separado com chave privada, se você preferir pagar direto de uma conta TRON; veja os exemplos de código oficiais.
Também posso comprar largura de banda?
Sim, com a mesma chamada buyResource usando "resourceType": "BANDWIDTH".
E outras linguagens?
Existem SDKs oficiais para TypeScript, Rust, Python e PHP. Temos guias passo a passo para TypeScript, Python, PHP e Rust.
Preciso usar o SDK para comprar energia TRON em Java?
Não. Ele encapsula a API HTTP v2 documentada, então você pode chamar os endpoints diretamente com qualquer cliente HTTP. O SDK só poupa você da parte trabalhosa das requisições, dos retries, do rate limiting e da tipagem das respostas, que é exatamente o código que você menos quer manter por conta própria num fluxo de pagamentos.
Está construindo um serviço de pagamentos? Adicione io.tronsave:sdk, gere uma chave de API no painel da TronSave e o seu backend passa a alugar a própria energia: estimar, comprar, acompanhar, pronto.
O SDK e a API da TronSave são operados pela TronSave, a editora deste blog. Teste na Nile antes de apontar qualquer integração para fundos da mainnet.


