
Resposta curta (novembro de 2026): para comprar energia TRON com uma API, obtenha uma API key da TronSave (conecte uma carteira em tronsave.io/market → Account Info → Login TronSave), deposite pelo menos 10 TRX na sua conta interna e faça duas chamadas HTTP: POST https://api.tronsave.io/v2/estimate-buy-resource para cotar a ordem e POST https://api.tronsave.io/v2/buy-resource com o header apikey: YOUR_API_KEY para comprá-la. Confira o resultado com GET /v2/order/{orderId}. A energia para uma transferência de USDT (cerca de 65.000 unidades por 15 minutos) custava cerca de 4,2 TRX em novembro de 2026, contra cerca de 6,43 TRX queimados.
Este guia trata da REST API pura: chamadas HTTP simples que você pode fazer de qualquer linguagem, de um cron job ou de uma ferramenta no-code. Se preferir instalar um pacote, o guia do TronSave SDK encapsula os mesmos endpoints para Node.js, Python, Rust, Java e PHP.
Pontos principais
- A API atual da TronSave é a v2 (URL base
https://api.tronsave.io; testnet Nilehttps://api-dev.tronsave.io). Os endpoints antigos da v0, como/v0/estimate-trx, são legados e mantidos apenas por compatibilidade. - Duas formas de pagar: uma API key com conta interna pré-carregada (sem assinatura on-chain por ordem, ideal para bots) ou uma transação assinada paga da sua própria carteira a cada ordem (sem custódia).
- Uma transferência de USDT (TRC-20) precisa de cerca de 64.285 de energia para um endereço que já tem USDT e cerca de 130.285 para um endereço que nunca teve USDT. Sem energia, a rede queima cerca de 6,43 TRX ou 13,03 TRX (100 sun por unidade de energia, em novembro de 2026).
- A maioria dos endpoints permite 15 requisições por segundo. Os erros voltam como códigos no estilo
{"error": true, "message": "TSAS:107 INVALID_API_KEY"}, que você pode tratar no código. - Alugar energia em vez de queimar TRX economiza até 80%, dependendo da quantidade e da duração.
O que faz uma API de energia TRON?
Uma API de energia TRON permite que o seu código alugue energia, o recurso da TRON que paga chamadas de contratos inteligentes como transferências de USDT, sem abrir nenhum site. O seu backend envia uma requisição com o endereço receptor, a quantidade e a duração; a TronSave a combina com vendedores de energia e a energia é delegada a esse endereço, normalmente em segundos.
Por que vale a pena: um endereço sem energia paga cada transferência de USDT queimando TRX. Em novembro de 2026 a rede cobra 100 sun por unidade de energia, então uma transferência queima cerca de 6,43 TRX (cerca de 13,03 TRX para um endereço que nunca teve USDT). A quantidade de TRX não depende do preço do TRX; só o valor em dólares depende. Uma exchange, gateway de pagamento, carteira ou script de folha de pagamento que envia centenas de transferências por dia paga bem menos alugando a energia antes. Contexto: energia e largura de banda da TRON explicadas.
O seu código deve alugar, fazer staking ou queimar?
| Opção | Custo de uma transferência de USDT (novembro de 2026) | Ideal para |
|---|---|---|
| Queimar TRX (sem energia) | ≈ 6,43 TRX (≈ 13,03 TRX para um novo endereço USDT) | Transferências raras e pontuais |
| Alugar via API, 15 minutos | ≈ 4,2 TRX por 65.000 de energia a ≈ 65 sun | Envios em picos ou imprevisíveis |
| Alugar via API, 30 dias | ≈ 2,4 TRX por transferência (1.000.000 de energia a ≈ 37 sun por dia) | Volume diário constante |
| Fazer staking do seu próprio TRX | Sem custo por transferência, mas ≈ 6.650 TRX bloqueados por transferência diária | Grandes detentores de TRX |
Os preços vêm do mercado da TronSave em 12 de novembro de 2026 e mudam com a oferta e a demanda; veja o relatório mensal de preço da energia TRON para a tabela atual. Cálculo de staking: guia do Stake 2.0 da TRON.
Como comprar energia TRON com a API, passo a passo?
Estes passos usam o método da API key do quickstart oficial para desenvolvedores da TronSave. Todos os exemplos funcionam na testnet Nile se você trocar a URL base por https://api-dev.tronsave.io (chaves e saldos são separados por rede; a Shasta não é suportada).
Passo 1: obtenha uma API key e carregue a conta interna
- Abra tronsave.io/market e clique em Connect para conectar sua carteira (TronLink ou outra carteira TRON).
- Clique no seu endereço → Account Info → Login TronSave e assine a mensagem.
- Copie a API key e o endereço de depósito que aparecem. Você também pode obter a chave no bot da TronSave no Telegram, em User Info → API key.
- Clique em Top up e envie TRX para o endereço de depósito. O depósito mínimo é de 10 TRX; o primeiro depósito custa cerca de 1 TRX a mais para ativar o endereço e, depois de 2 depósitos gratuitos por dia, cada depósito extra custa 0,3 TRX (documentação da TronSave, novembro de 2026).
Confira se o saldo chegou (ele é atualizado em cerca de 3 segundos):
curl https://api.tronsave.io/v2/user-info -H "apikey: YOUR_API_KEY"
# {"error": false, "data": {"balance": "50000000", "depositAddress": "T...", ...}}
# balance is in sun: 50000000 sun = 50 TRX
Passo 2: mantenha a API key em segredo
- A chave gasta o TRX que você depositou. Guarde-a apenas no servidor: em uma variável de ambiente ou em um gerenciador de segredos, nunca no código front-end nem em um repositório git.
- Deposite só o que o seu bot precisa para alguns dias. Assim, o saldo interno funciona como um limite de gastos.
- Se a chave vazar, clique em Revoke (no site ou no Telegram) para gerar uma nova. A chave antiga para de funcionar na hora, então atualize todos os serviços que a usam.
Passo 3: estime o preço e depois crie a ordem
Peça uma cotação primeiro. A chamada de estimativa não precisa de API key:
curl -X POST https://api.tronsave.io/v2/estimate-buy-resource \
-H "Content-Type: application/json" \
-d '{
"receiver": "TYourReceiverAddress",
"resourceType": "ENERGY",
"resourceAmount": 65000,
"durationSec": 900,
"unitPrice": "MEDIUM"
}'
# {"error": false, "data": {"unitPrice": 64, "durationSec": 900,
# "estimateTrx": 4230000, "availableResource": 65000}}
estimateTrx vem em sun (4.230.000 sun = 4,23 TRX). Se availableResource for menor que a sua quantidade, o mercado não consegue preencher a ordem inteira agora. unitPrice aceita "SLOW" (mais barato, sem pressa), "MEDIUM" (padrão) ou "FAST" (preenche já, preço mais alto). durationSec é o tempo de aluguel em segundos: 900 = 15 minutos, 259200 = 3 dias.
Depois compre, com o mesmo corpo mais a sua chave e as opções da ordem:
curl -X POST https://api.tronsave.io/v2/buy-resource \
-H "apikey: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"receiver": "TYourReceiverAddress",
"resourceType": "ENERGY",
"resourceAmount": 65000,
"durationSec": 900,
"unitPrice": "MEDIUM",
"options": {
"allowPartialFill": true,
"preventDuplicateIncompleteOrders": true,
"maxPriceAccepted": 100
}
}'
# {"error": false, "message": "Success", "data": {"orderId": "6818426a65fa8ea36d119999"}}
O que as opções fazem: allowPartialFill aceita parte da quantidade quando falta oferta; preventDuplicateIncompleteOrders impede que uma nova tentativa crie uma segunda ordem enquanto a primeira ainda está aberta; maxPriceAccepted (sun) rejeita a ordem se o preço passar do seu limite. Para uma ordem que precisa ser preenchida por completo ou não ser criada, use onlyCreateWhenFulfilled: true. Como isso corresponde aos tipos de ordem do site: tipos de ordem da TronSave explicados.
Passo 4: confira a ordem e a energia delegada
curl https://api.tronsave.io/v2/order/6818426a65fa8ea36d119999 -H "apikey: YOUR_API_KEY"
# "fulfilledPercent": 100 -> fully delegated
# "fulfilledPercent": 1-99 -> partly filled (only with allowPartialFill)
# "fulfilledPercent": 0 -> waiting for a seller
# "delegates": [{"delegator": "T...", "amount": 65000, "txid": "..."}]
Cada txid é uma delegação on-chain que você pode abrir no TronScan. Para confirmar que o receptor realmente tem a energia antes de enviar USDT, leia os recursos dele em um nó TRON (TronGrid wallet/getaccountresource; veja como obter uma API key do TronGrid).
Como fica o fluxo completo em código?
Um script mínimo em Node.js 18+ (fetch nativo, sem pacotes) que estima, compra com teto de preço e espera o preenchimento:
const API = "https://api.tronsave.io"; // testnet: https://api-dev.tronsave.io
const KEY = process.env.TRONSAVE_API_KEY;
const RECEIVER = process.env.RECEIVER;
async function call(path, body) {
const res = await fetch(API + path, {
method: body ? "POST" : "GET",
headers: { "apikey": KEY, "Content-Type": "application/json" },
body: body ? JSON.stringify(body) : undefined,
});
const json = await res.json();
if (json.error) throw new Error(json.message); // e.g. "TSAS:107 INVALID_API_KEY"
return json.data;
}
async function buyEnergy(amount = 65000, durationSec = 900) {
const order = { receiver: RECEIVER, resourceType: "ENERGY",
resourceAmount: amount, durationSec, unitPrice: "MEDIUM" };
const est = await call("/v2/estimate-buy-resource", order);
console.log("Estimated cost:", est.estimateTrx / 1e6, "TRX");
const { orderId } = await call("/v2/buy-resource", { ...order,
options: { allowPartialFill: true, preventDuplicateIncompleteOrders: true,
maxPriceAccepted: 100 } });
for (let i = 0; i < 12; i++) { // poll up to ~1 minute
await new Promise(r => setTimeout(r, 5000));
const s = await call("/v2/order/" + orderId);
if (s.fulfilledPercent === 100) return s;
}
throw new Error("Order " + orderId + " not filled yet");
}
buyEnergy().then(s => console.log("Delegated", s.resourceAmount, "energy"));
As mesmas três chamadas funcionam em Python (requests), PHP (cURL), Go ou em uma etapa HTTP no-code. Mais exemplos completos estão nos exemplos de código da TronSave.

API key ou transação assinada: qual usar?
| API key (conta interna) | Transação assinada | |
|---|---|---|
| Quem paga | O seu saldo pré-carregado na TronSave | A sua própria carteira, a cada ordem |
| Taxa on-chain por ordem | Nenhuma | Sim (a transação de pagamento em TRX) |
| Integração | Um header, a mais simples | Estimar → assinar (no seu código ou via POST /v2/signed-tx) → criar a ordem |
| Custódia | A TronSave guarda o TRX depositado | Sem custódia |
| Ideal para | Bots, exchanges, backends de alto volume | Apps de carteira e fluxos que não podem deixar fundos com terceiros |
Os dois usam os mesmos endpoints /v2/estimate-buy-resource e /v2/buy-resource; o fluxo com transação assinada envia o pagamento em TRX assinado junto com a ordem, em vez do header apikey. Detalhes: Buy Resources na documentação da TronSave.
O que mais a API da TronSave faz?
- Estender ordens: encontre delegações que podem ser estendidas e adicione tempo antes que expirem, em vez de comprar de novo (a mesma ideia do Extend no site).
- Largura de banda: defina
resourceTypecomo"BANDWIDTH"para transferências de TRX e outras transações que usam só largura de banda. - Ativar endereços: verifique se os endereços estão ativados e ative até 100 por requisição, útil antes de pagar novos usuários.
- Vender energia: anuncie a sua própria energia em staking no mercado (esses endpoints permitem de 2 a 3 requisições por segundo).
- Agentes de IA: o servidor MCP da TronSave expõe as mesmas ações para Claude, Cursor e outros clientes MCP.
Não é desenvolvedor? O Auto-Buy mantém um endereço abastecido sem código.
Quanto se economiza comprando energia por API?
Exemplo de um serviço que envia 200 transferências de USDT por dia para endereços que já têm USDT (preços de novembro de 2026):
| Método | TRX por dia | TRX em 30 dias |
|---|---|---|
| Queimar TRX (≈ 6,43 TRX cada) | ≈ 1.286 | ≈ 38.570 |
| Alugar por transferência, 15 min (≈ 4,2 TRX cada) | ≈ 840 | ≈ 25.200 |
| Alugar um bloco de 30 dias (≈ 2,4 TRX por transferência) | ≈ 480 | ≈ 14.400 |
O bloco de 30 dias funciona porque a energia delegada se recarrega em 24 horas, então um bloco de energia cobre um número fixo de transferências todos os dias. Os preços de aluguel mudam com o mercado, por isso cote cada ordem com o endpoint de estimativa antes de montar o orçamento; a economia chega a até 80% em relação a queimar TRX, dependendo da quantidade e da duração. Ajuda para dimensionar: quanto TRX você precisa para enviar USDT.
Como manter uma automação de energia segura e confiável?
- Trate os limites de requisição: a maioria dos endpoints permite 15 requisições por segundo e, acima disso, retorna HTTP 429
Rate limit reached. Tente de novo com backoff (1 s, 2 s, 4 s). - Trate os erros comuns:
API_KEY_REQUIRED/INVALID_API_KEY(401, verifique o header),INTERNAL_BALANCE_ACCOUNT_TOO_LOW(recarregue o saldo),CANNOT_FULFILLED(permita preenchimento parcial ou aumente ounitPrice),PRICE_EXCEED_MAX_PRICE_REQUIRED(mercado acima do seumaxPriceAccepted). Compare pelo código, não pelo texto da mensagem. - Torne as novas tentativas seguras: mantenha
preventDuplicateIncompleteOrders: truepara que um timeout seguido de nova tentativa não compre duas vezes. - Limite o preço: defina
maxPriceAcceptedabaixo do preço de queima de 100 sun (em novembro de 2026); alugar acima disso nunca compensa. - Teste primeiro na Nile: pegue TRX de teste no faucet da Nile e rode o fluxo completo em
api-dev.tronsave.io.
Perguntas frequentes
A TronSave tem uma API para comprar energia TRON?
Sim. A REST API v2 da TronSave em https://api.tronsave.io permite estimar, comprar, consultar e estender ordens de energia e largura de banda. Os SDKs oficiais para Node.js, Python, Rust, Java e PHP e um servidor MCP usam a mesma API.
Como obtenho uma API key da TronSave?
Conecte uma carteira em tronsave.io/market, abra Account Info, clique em Login TronSave e assine. A API key e o endereço de depósito aparecem ali. No bot do Telegram, fica em User Info → API key.
A API v0 (/v0/estimate-trx) ainda funciona?
Ela é mantida por compatibilidade, mas a TronSave documenta a v2 como a API atual em novembro de 2026. Novas integrações devem usar /v2/estimate-buy-resource e /v2/buy-resource.
Quanta energia o meu código deve comprar para uma transferência de USDT?
Cerca de 65.000 de energia se o receptor já tem USDT e cerca de 131.000 se ele nunca teve USDT (exatamente 64.285 e 130.285, em novembro de 2026). Comprar um pouco a mais cobre pequenas mudanças no contrato.
Em quanto tempo a energia chega?
Normalmente de alguns segundos a alguns minutos depois que a ordem é combinada. Consulte GET /v2/order/{orderId} até que fulfilledPercent seja 100 antes de enviar a transferência.
Posso comprar energia para outro endereço?
Sim. Defina receiver como qualquer endereço TRON, por exemplo o de um cliente ou de uma hot wallet. Quem paga e quem recebe podem ser diferentes. Veja como comprar energia para outra carteira.
Por que minha transferência de USDT ainda queima TRX depois de comprar energia?
A ordem pode ter sido preenchida só em parte, a energia pode ter ido para outro endereço, o aluguel pode ter expirado, ou o receptor nunca teve USDT e a transferência precisa de cerca de 130.285 de energia. O remetente também precisa de largura de banda (ou um pouco de TRX) para a própria transação.
⚠️ Não é recomendação financeira. Este artigo tem fins apenas educativos e informativos e reflete a opinião do autor no momento em que foi escrito. Ele não é recomendação de investimento, financeira, jurídica ou tributária. Criptomoedas são altamente voláteis e você pode perder todo o capital investido; preços, APYs e taxas on-chain mudam o tempo todo e podem estar desatualizados. Sempre faça sua própria pesquisa (DYOR) e consulte um consultor financeiro habilitado antes de comprar, vender, fazer staking ou emprestar qualquer ativo digital.
Aviso de transparência: este é o blog oficial da TronSave. A TronSave vende serviços de energia/recursos da TRON (para redução de taxas) e tem interesse comercial nos produtos e temas abordados aqui.
Prefere um SDK? Veja como comprar energia TRON com código usando o TronSave SDK (Node.js, Python, Rust, Java, PHP).


