API TronRental para iniciantes: compre energia TRON em 7 passos
Guia passo a passo para desenvolvedores sem experiência com TRON. Do cadastro à primeira compra de energia via API.
Para quem é este guia?
Este guia é para desenvolvedores, criadores de bots e proprietários de negócios que desejam automatizar a compra de energia e largura de banda TRON. Não é necessária experiência prévia com TRON.
Ao final deste guia, você poderá consultar preços, comprar energia e largura de banda, e verificar o status dos pedidos — tudo a partir do seu próprio código.
O que você pode construir com a API:
Um bot que compra energia automaticamente antes de cada transferência USDT
Integração na sua própria exchange, carteira ou serviço de pagamento
Compras em massa de energia para vários endereços de uma vez
O que é uma API e por que usá-la?
API (Interface de Programação de Aplicações) é uma forma de controlar um serviço a partir de código em vez de clicar botões em um site. Pense nisso como um controle remoto para o TronRental.
Com a API TronRental você pode fazer tudo o que o site faz — consultar preços, comprar energia, comprar largura de banda — mas automaticamente, a partir de um script ou servidor.
Manual vs API
Manual: abrir o site, fazer login, digitar endereço, escolher volume, clicar comprar, esperar, repetir
API: uma requisição HTTP → energia delegada em segundos. Sem necessidade de navegador.
Passo 1 — Cadastro e Login
Acesse tronrental.com e crie uma conta. Você pode se cadastrar com email, Google, Telegram ou carteira TronLink.
Após o cadastro, vá para o Dashboard. Aqui você gerencia tudo: saldo, pedidos, chaves API e configurações.
Passo 2 — Criar uma chave API
No Dashboard, vá para a seção API e clique em "Create API Key".
Importante: a chave API é mostrada apenas uma vez. Copie e guarde em local seguro. Se perder, precisará criar uma nova.
Uma chave API é como uma senha para seu script. Ela informa ao TronRental quem está fazendo a requisição e cobra do seu saldo.
Opcional: você pode restringir a chave a endereços IP específicos para segurança extra.
Opcional: configure uma URL de Webhook para receber notificações automáticas quando o status do pedido mudar.
Passo 3 — Depositar fundos
Vá para Dashboard → Deposit e copie seu endereço de depósito pessoal.
Envie TRX ou USDT (TRC-20) para este endereço. O depósito é confirmado normalmente em 30 segundos.
Verifique seu saldo via API:
curl -X GET https://tronrental.com/api/v1/account/balance \
-H "Authorization: Bearer YOUR_API_KEY"# Python
import requests
API_KEY = "YOUR_API_KEY"
headers = {"Authorization": f"Bearer {API_KEY}"}
r = requests.get("https://tronrental.com/api/v1/account/balance", headers=headers)
print(r.json())// JavaScript (Node.js)
const API_KEY = "YOUR_API_KEY";
const res = await fetch("https://tronrental.com/api/v1/account/balance", {
headers: { "Authorization": `Bearer ${API_KEY}` }
});
console.log(await res.json());Resposta:
{
"balance_trx": "150.50",
"balance_usdt": "0.00",
"deposit_address": "TYour1Deposit2Address3Here..."
}Passo 4 — Verificar preços atuais
Antes de comprar, verifique os preços atuais. Este endpoint é público — não requer chave API.
curl -X GET https://tronrental.com/api/v1/prices# Python
import requests
r = requests.get("https://tronrental.com/api/v1/prices")
print(r.json())// JavaScript
const res = await fetch("https://tronrental.com/api/v1/prices");
console.log(await res.json());Resposta:
{
"energy": {
"1h": "0.84",
"1d": "4.20"
},
"bandwidth": {
"1d": "9.60"
},
"burn_cost_trx": "6.43",
"savings_percent": "87"
}Campos da resposta:
- energy.1h — preço por 1.000 unidades de energia por 1 hora (em TRX)
- bandwidth — preço por 1.000 unidades de largura de banda por 1 dia (em TRX)
- burn_cost_trx — quanto TRX você queimaria sem energia
- savings_percent — quanto você economiza alugando vs queimando
Fórmula do preço: price_per_1k × (volume / 1000). Exemplo: energy.1h = 0.84 TRX, 65.000 energia necessária: 0.84 × 65 = 54.6 TRX.
Passo 5 — Comprar energia
Agora a parte principal — comprar energia. Envie uma requisição POST com o endereço destino, volume e duração.
Parâmetros:
target_address— o endereço TRON que receberá a energiavolume— quantidade de energia (mín 32.000, máx 5.000.000)duration— período de aluguel: "1h" (1 hora) ou "1d" (1 dia)
Quanta energia você precisa? Para transferência USDT: 65.000 se o destinatário já tem USDT, ou 131.000 se não.
Requisição:
curl -X POST https://tronrental.com/api/v1/energy/buy \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"target_address": "TReceiverAddress...",
"volume": 65000,
"duration": "1h"
}'# Python
import requests
API_KEY = "YOUR_API_KEY"
headers = {
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json"
}
data = {
"target_address": "TReceiverAddress...",
"volume": 65000,
"duration": "1h"
}
r = requests.post("https://tronrental.com/api/v1/energy/buy",
headers=headers, json=data)
print(r.json())// JavaScript (Node.js)
const API_KEY = "YOUR_API_KEY";
const res = await fetch("https://tronrental.com/api/v1/energy/buy", {
method: "POST",
headers: {
"Authorization": `Bearer ${API_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
target_address: "TReceiverAddress...",
volume: 65000,
duration: "1h"
})
});
console.log(await res.json());Resposta:
{
"id": 1234,
"type": "energy",
"target_address": "TReceiverAddress...",
"volume": 65000,
"duration": "1h",
"price_trx": "54.60",
"status": "pending",
"created_at": "2026-02-28T12:00:00Z"
}Status do pedido:
- pending — pedido criado, aguardando processamento
- delegated — energia delegada ao endereço destino
- completed — período de aluguel encerrado, energia recuperada
Passo 6 — Comprar largura de banda
Largura de banda funciona da mesma forma que energia. É necessária para qualquer transação TRON (não apenas USDT).
Parâmetros:
target_address— o endereço TRON que receberá a largura de bandavolume— quantidade de largura de banda (mín 350, máx 100.000)duration— período de aluguel: "1h"
Uma taxa fixa de 0.2 TRX é adicionada a cada pedido de largura de banda.
Requisição:
curl -X POST https://tronrental.com/api/v1/bandwidth/buy \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"target_address": "TReceiverAddress...",
"volume": 5000,
"duration": "1h"
}'# Python
import requests
API_KEY = "YOUR_API_KEY"
headers = {
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json"
}
data = {
"target_address": "TReceiverAddress...",
"volume": 5000,
"duration": "1h"
}
r = requests.post("https://tronrental.com/api/v1/bandwidth/buy",
headers=headers, json=data)
print(r.json())// JavaScript (Node.js)
const API_KEY = "YOUR_API_KEY";
const res = await fetch("https://tronrental.com/api/v1/bandwidth/buy", {
method: "POST",
headers: {
"Authorization": `Bearer ${API_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
target_address: "TReceiverAddress...",
volume: 5000,
duration: "1h"
})
});
console.log(await res.json());Resposta:
{
"id": 1235,
"type": "bandwidth",
"target_address": "TReceiverAddress...",
"volume": 5000,
"duration": "1h",
"price_trx": "2.20",
"status": "pending",
"created_at": "2026-02-28T12:05:00Z"
}Passo 7 — Verificar status do pedido
Após fazer um pedido, você pode verificar seu status a qualquer momento.
Obter todos os pedidos:
curl -X GET https://tronrental.com/api/v1/orders \
-H "Authorization: Bearer YOUR_API_KEY"Obter um pedido específico por ID:
curl -X GET https://tronrental.com/api/v1/orders/1234 \
-H "Authorization: Bearer YOUR_API_KEY"# Python
import requests
API_KEY = "YOUR_API_KEY"
headers = {"Authorization": f"Bearer {API_KEY}"}
# All orders
orders = requests.get("https://tronrental.com/api/v1/orders",
headers=headers).json()
# Single order
order = requests.get("https://tronrental.com/api/v1/orders/1234",
headers=headers).json()
print(order["status"]) # "delegated"Resposta:
{
"id": 1234,
"type": "energy",
"target_address": "TReceiverAddress...",
"volume": 65000,
"duration": "1h",
"price_trx": "54.60",
"status": "delegated",
"delegate_txid": "abc123def456...",
"created_at": "2026-02-28T12:00:00Z",
"delegated_at": "2026-02-28T12:00:04Z"
}Procure o campo "status". Quando mostra "delegated", a energia ou largura de banda foi entregue com sucesso. O campo "delegate_txid" contém o hash da transação.
Melhores práticas e dicas
Segurança
Nunca codifique sua chave API diretamente no código-fonte. Use variáveis de ambiente:
Python:
import os
API_KEY = os.environ["TRONRENTAL_API_KEY"]JavaScript/Node.js:
const API_KEY = process.env.TRONRENTAL_API_KEY;Lista branca de IP
Para produção, sempre configure uma lista branca de IP na sua chave API. Mesmo se a chave vazar, não poderá ser usada de outro servidor.
Limites de taxa
A API permite 30 requisições por 60 segundos por chave. Se exceder, receberá uma resposta 429. Adicione um pequeno atraso entre requisições.
Erros comuns
Os códigos de erro mais comuns e o que fazer:
401 Unauthorized — chave API inválida ou ausente. Verifique o header Authorization.
400 Bad Request — parâmetros inválidos. Verifique a mensagem de erro na resposta.
402 Payment Required — saldo insuficiente. Deposite mais TRX.
429 Too Many Requests — limite excedido. Aguarde e tente novamente.
Webhooks
Em vez de consultar o status constantemente, configure uma URL de webhook. TronRental enviará uma requisição POST quando o status mudar.
O payload do webhook inclui o objeto de pedido completo com o status atualizado.
Perguntas frequentes
Quanta energia preciso para uma transferência USDT?
65.000 energia se o destinatário já tem USDT, ou 131.000 se não. Use nossa Calculadora de Energia para verificar qualquer endereço.
Quão rápido a energia é delegada?
Normalmente em 3-5 segundos após o pedido.
O que acontece se meu saldo acabar?
A API retornará erro 402. Pedidos existentes permanecem ativos. Simplesmente deposite mais TRX e continue.
Posso comprar energia para o endereço de outra pessoa?
Sim. target_address pode ser qualquer endereço TRON válido. Você não precisa ser o proprietário.
Quais linguagens de programação são suportadas?
Qualquer linguagem que faça requisições HTTP. Mostramos exemplos em Python, JavaScript e curl, mas você pode usar Go, PHP, Java, Rust ou qualquer outra.