Does the TronEnergy API require authentication?

No API key or sign-up required. You authenticate each request by signing a message that proves you are the payment sender. No credentials, no API keys.

How does the delegation flow work?

Send TRX to the payment address. Sign the message {tx_hash}:{delegate_to} to prove you are the sender. Call POST /delegate with tx_hash, delegate_to, and signature. Energy arrives in ~3 seconds.

What happens if delegation fails after payment?

A TRX refund is automatically queued and sent back to the sender address on-chain.

API ma'lumotnomasi | TronEnergy Docs

Asosiy URL: https://api.tronnrg.com Avtorizatsiya: Talab qilinmaydi. Barcha oxirgi nuqtalar ommaviydir. Narx chegarasi: Har bir IP uchun soniyasiga 20 ta so'rov To'lov manzili: TFqUiCu1JwLHHnBNeaaVKH7Csm4aA3YhZx (Faqat API , qo'lda ijaraga olish uchun emas)

Qanday ishlaydi

Uch bosqich. API kaliti yo'q, ro'yxatdan o'tish yo'q, hamyonga ulanish yo'q. Mulkiylik kriptografik tarzda tasdiqlangan.

TRX yuborish — To'lov manziliga 4 ta TRX (yoki undan ko'p) yuboring. 4 ta TRX = 65 000 energiya. 8 ta TRX = 130 000. Chiziqli.
Belgi — Xabarni imzolang {tx_hash}:{delegate_to} TRX yuborgan hamyondan foydalanish. Bu sizning delegatsiyaga vakolat berganingizni isbotlaydi.
Talab — POST /delegate bilan tx_hash, delegate_tova signatureEnergy taxminan 3 soniyada yetib keladi.

To'lov manzili

TFqUiCu1JwLHHnBNeaaVKH7Csm4aA3YhZx

Faqat API to'lov manzili. Bu manzil API orqali dasturiy integratsiyalar uchun. Buni qo'lda energiya ijarasi uchun ishlatmang. Qo'lda ijaraga olish manzili boshqacha va saytida mavjud.tronnrg.com.

TRX ushbu manzilga yuboring. To'lovingizning tranzaksiya xeshi delegatsiyani ishga tushirish uchun tokeningizdir. Har bir xeshdan faqat bir marta foydalanish mumkin.

TRX yuborildi	Energy vakolati berilgan	Foydalanish holati
4 TRX	65,000	Mavjud hamyonga standart USDT o'tkazmasi (minimal buyurtma)
8 TRX	130,000	Birinchi marta oluvchiga USDT o'tkazmasi
16 TRX	260,000	Bitta tartibda to'rtta standart o'tkazmalar
40 TRX	650,000	O'nta standart transfer
100 TRX	1,625,000	~25 ta standart uzatishlar — kichik platformalar uchun keng tarqalgan
1,000 TRX	16,250,000	Maksimal buyurtma, ~250 ta standart o'tkazmalar
Oradagi har qanday miqdor	`trx × 16,250`	To'liq chiziqli. Hech qanday darajalar, paketlar, chegirmalar yo'q.

Formula: energy = trxSent × 16,250. Chegaralar: minimal 4 TRX (65 000 energiya), maksimal 1 000 TRX (16 250 000 energiya). Ikkalasi ham API darajasida amalga oshiriladi — minimaldan past miqdorlar below_minimum bilan rad etiladi va qaytariladi; maksimaldan yuqori miqdorlar vakolat berishdan oldin rad etiladi. Ishlab chiqarishda qattiq kodlashdan oldin har doim GET /supply dan olingan jonli qiymatlarni o'qing — quyida ko'rib chiqing.

GET /supply

GET/supply

Narxlar haqida ma'lumot va to'lov manzilini oling. Bu axborot beruvchi yakuniy nuqta — energiya har doim mavjud, to'lovni yuborishdan oldin tekshirishingiz shart emas.

curl https://api.tronnrg.com/supply

const supply = await fetch('https://api.tronnrg.com/supply')
  .then(r => r.json());

// Energy is always available. Use supply.pay_to for the payment address.
console.log('Pay to:', supply.pay_to);

import requests

supply = requests.get('https://api.tronnrg.com/supply').json()

# Energy is always available. Use supply['pay_to'] for the payment address.
print(supply['pay_to'])

$supply = json_decode(
    file_get_contents('https://api.tronnrg.com/supply'),
    true
);

// if less than you require, wait and retry
// Energy is always available. Use $supply['pay_to'] for the payment address.
echo $supply['pay_to'];

var client = new HttpClient();
var json = await client.GetStringAsync("https://api.tronnrg.com/supply");
var supply = JsonSerializer.Deserialize<JsonElement>(json);

// Energy is always available. Use pay_to for the payment address.
var payTo = supply.GetProperty("pay_to").GetString();

Response 200
{
  "available": true,
  "energy_per_trx": 16250,
  "min_order_trx": 4,
  "max_order_trx": 1000,
  "pay_to": "TFqUiCu1JwLHHnBNeaaVKH7Csm4aA3YhZx",
  "examples": {
    "standard":   { "trx": 4, "energy": 65000,  "note": "Existing USDT wallet" },
    "new_wallet": { "trx": 8, "energy": 130000, "note": "First-time USDT recipient" }
  }
}

POST /delegate

POST/delegate

Energiya delegatsiyasini talab qiling. Siz allaqachon TRX zanjirdagi to'lov manziliga yuborgan bo'lishingiz kerak. Tranzaksiya xeshini, qabul qiluvchining manzilini va jo'natuvchi ekanligingizni tasdiqlovchi imzoni uzating.

Parameter	Type		Description
tx_hash	string	required	TRX to'lovining 64 belgili olti burchakli xeshi
delegate_to	string	required	Energiyani olish uchun Tron manzili
signature	string	required	Sign `{tx_hash}:{delegate_to}` using `tronWeb.trx.signMessageV2()`. Proves you are the payment sender.

curl -X POST https://api.tronnrg.com/delegate \
  -H "Content-Type: application/json" \
  -d '{"tx_hash":"TX_HASH","delegate_to":"TWallet","signature":"SIG"}'

const result = await fetch('https://api.tronnrg.com/delegate', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    tx_hash: 'YOUR_TX_HASH',
    delegate_to: 'TWalletAddress',
    signature: 'YOUR_SIGNATURE',
  }),
}).then(r => r.json());

if (result.error) {
  console.error(result.error, result.message);
} else {
  console.log('Delegated:', result.energy, 'energy');
  console.log('Ref:', result.ref);
}

import requests

response = requests.post('https://api.tronnrg.com/delegate', json={
    'tx_hash': 'YOUR_TX_HASH',
    'delegate_to': 'TWalletAddress',
    'signature': 'YOUR_SIGNATURE',
})
result = response.json()

if 'error' in result:
    print(f"Error: {result['error']} - {result['message']}")
else:
    print(f"Delegated: {result['energy']} energy")
print(f"Delegation tx: {result['delegations'][0]['tx']}")
print(f"Ref: {result['ref']}")

$ch = curl_init('https://api.tronnrg.com/delegate');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode([
        'tx_hash' => 'YOUR_TX_HASH',
        'delegate_to' => 'TWalletAddress',
        'signature' => 'YOUR_SIGNATURE',
    ]),
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);

if (isset($result['error'])) {
    echo "Error: " . $result['message'];
} else {
    echo "Delegated: " . $result['energy'] . " energy";
}

var client = new HttpClient();
var content = new StringContent(
    JsonSerializer.Serialize(new {
        tx_hash = "YOUR_TX_HASH",
        delegate_to = "TWalletAddress",
        signature = "YOUR_SIGNATURE"
    }),
    Encoding.UTF8, "application/json"
);

var response = await client.PostAsync("https://api.tronnrg.com/delegate", content);
var json = await response.Content.ReadAsStringAsync();
var result = JsonSerializer.Deserialize<JsonElement>(json);

if (result.TryGetProperty("error", out var err))
    Console.WriteLine($"Error: {err}");
else
    Console.WriteLine($"Delegated: {result.GetProperty("energy")} energy");

Response 200
{
  "ref": "nrg_d_42",
  "delegate_to": "TWalletAddress",
  "energy": 65000,
  "cost": 4,
  "status": "delegated",
  "delegations": [
    { "tx": "a1b2c3d4e5f6...your delegation tx hash", "energy": 65000 }
  ]
}

Field	Type	Description
ref	string	TronNRG ma'lumotnoma identifikatori. Qo'llab-quvvatlash so'rovlari uchun buni qayd qiling.
energy	number	Delegatsiya qilingan umumiy energiya
cost	number	TRX zaryadlangan
status	string	muvaffaqiyatga "vakolat berilgan"
delegations	array	On-chain delegation transaction hashes. Each `tx` is verifiable on TronScan. This is your receipt.

GET /health

GET/health

Liveness check for monitoring and uptime tools. Returns 200 OK when the API process is up. Does not check upstream nodes or providers.

Response 200

{ "status": "ok" }

Xato kodlari

Every error response has error (stable, machine-readable) and message (human-readable). Always switch on error.

Code	HTTP	Meaning
`invalid_tx_hash`	400	64 belgili olti burchakli qator emas
`invalid_address`	400	Tron manzili noto'g'ri
`missing_signature`	400	Imzo taqdim etilmagan
`invalid_signature`	401	Imzo tekshirilmadi
`signature_mismatch`	403	Imzolovchining manzili to'lov jo'natuvchisi bilan mos kelmaydi
`hash_already_used`	409	Tranzaksiya xeshi allaqachon talab qilingan
`payment_verification_failed`	404 / 400	On-chain verification of the payment failed. Read the `message` field for the specific cause: tx not found yet (404, retry in a few seconds), wrong recipient, not a TRX transfer, or below the 4 TRX minimum.
`delegation_failed`	400 / 500	Provider could not deliver energy. If the failure happened after the payment was verified, an automatic refund is queued. The error response includes a `refund` object when this happens.
`rate_limited`	429	Bu IP manzildan soniyasiga juda ko'p so'rovlar. Cheklov 20/soniya.
`server_error`	500	Kutilmagan ichki xatolik. Bir necha soniyadan keyin qayta urinib ko'ring.

const result = await fetch('https://api.tronnrg.com/delegate', { ... })
  .then(r => r.json());

if (result.error) {
  switch (result.error) {
    case 'payment_verification_failed':
      // Most common cause: tx not yet indexed. Wait 3s and retry.
      // Read result.message for the specific cause.
      break;
    case 'hash_already_used':
      // Already claimed. Don't retry.
      break;
    case 'signature_mismatch':
      // Signer != payment sender. Sign with the same key that sent TRX.
      break;
    case 'delegation_failed':
      // Refund queued automatically if payment was verified.
      if (result.refund) console.log('Refund queued:', result.refund);
      break;
  }
}

result = requests.post('https://api.tronnrg.com/delegate', json=data).json()

if 'error' in result:
    if result['error'] == 'payment_verification_failed':
        # Most common cause: tx not yet indexed. Wait 3s and retry.
        pass
    elif result['error'] == 'hash_already_used':
        # Already claimed. Don't retry.
        pass
    elif result['error'] == 'signature_mismatch':
        # Signer != payment sender. Sign with the same key.
        pass
    elif result['error'] == 'delegation_failed':
        # Refund queued automatically if payment was verified.
        pass

if (isset($result['error'])) {
    switch ($result['error']) {
        case 'payment_verification_failed':
            // Most common cause: tx not yet indexed. Wait 3s and retry.
            break;
        case 'hash_already_used':
            // Already claimed. Don't retry.
            break;
        case 'signature_mismatch':
            // Signer != payment sender. Sign with the same key.
            break;
        case 'delegation_failed':
            // Refund queued automatically if payment was verified.
            break;
    }
}

Refunds

Agar to'lovingiz tasdiqlangandan so'ng vakolat berish amalga oshmasa, TRX qaytarilishi avtomatik ravishda navbatga qo'yiladi va jo'natuvchining manziliga zanjir orqali qaytariladi. Xato javobida qaytarilish obyektini qidiring.

Error with refund
{
  "error": "delegation_failed",
  "message": "Energy delegation failed. Your payment will be refunded.",
  "ref": "nrg_d_43",
  "refund": {
    "type": "queued",
    "to": "TSenderAddress",
    "amount": 4
  }
}

To'liq misol

To'liq boshdan-oyoq oqim: TRX yuborish, imzolash, qayta urinish bilan da'vo qilish. Nusxalash va ishga tushirish.

const API  = 'https://api.tronnrg.com';
const ADDR = 'TFqUiCu1JwLHHnBNeaaVKH7Csm4aA3YhZx';

async function rentEnergy(delegateTo, trxAmount = 4) {
  // 1. Send TRX to the payment address
  const payment = await tronWeb.trx.sendTransaction(ADDR, trxAmount * 1e6);

  // 2. Sign: proves you are the sender
  const message = `${payment.txid}:${delegateTo}`;
  const signature = await tronWeb.trx.signMessageV2(message);

  // 3. Claim delegation (retry if tx not indexed yet)
  let result;
  for (let i = 0; i < 3; i++) {
    result = await fetch(`${API}/delegate`, {
      method:  'POST',
      headers: { 'Content-Type': 'application/json' },
      body:    JSON.stringify({
        tx_hash:     payment.txid,
        delegate_to: delegateTo,
        signature,
      }),
    }).then(r => r.json());

    if (!result.error) break;
    if (result.error !== 'payment_verification_failed') throw new Error(result.message);
    await new Promise(r => setTimeout(r, 3000));
  }

  if (result.error) throw new Error(result.message);
  return result;
}

// Usage — send any amount between 4 and 1,000 TRX
const result = await rentEnergy('TWalletThatNeedsEnergy', 4);  // 4 TRX → 65k energy
// rentEnergy(addr, 8)    // → 130,000 energy (new-wallet transfer)
// rentEnergy(addr, 40)   // → 650,000 energy (10 transfers)
// rentEnergy(addr, 1000) // → 16,250,000 energy (max)
console.log(result.energy);              // trxAmount × 16,250
console.log(result.delegations[0].tx);  // on-chain tx hash
console.log(result.ref);                 // "nrg_d_42"

import requests
import time

API  = 'https://api.tronnrg.com'
ADDR = 'TFqUiCu1JwLHHnBNeaaVKH7Csm4aA3YhZx'

def rent_energy(delegate_to, trx_amount=4):
    # 1. Send TRX to ADDR (via your Tron library)
    tx_hash = send_trx(ADDR, trx_amount)  # your TRX send function

    # 2. Sign: proves you are the sender
    message = f'{tx_hash}:{delegate_to}'
    signature = tron.trx.sign_message_v2(message)

    # 3. Claim delegation (retry if tx not indexed yet)
    for attempt in range(3):
        result = requests.post(f'{API}/delegate', json={
            'tx_hash':     tx_hash,
            'delegate_to': delegate_to,
            'signature':   signature,
        }).json()

        if 'error' not in result:
            return result
        if result['error'] != 'payment_verification_failed':
            raise Exception(result['message'])
        time.sleep(3)

    raise Exception('Transaction not found after retries')

# Usage
result = rent_energy('TWalletThatNeedsEnergy', 4)
print(f"Delegated: {result['energy']} energy")
print(f"Delegation tx: {result['delegations'][0]['tx']}")
print(f"Ref: {result['ref']}")

<?php
$api  = 'https://api.tronnrg.com';
$addr = 'TFqUiCu1JwLHHnBNeaaVKH7Csm4aA3YhZx';

function rentEnergy($api, $txHash, $delegateTo, $signature) {
    // 1. Send TRX to $addr (via iexbase/tron-api)
    // $payment = $tron->sendTrx($addr, 4);
    // $txHash = $payment['txid'];

    // 3. Claim delegation (retry if tx not indexed yet)
    for ($i = 0; $i < 3; $i++) {
        $ch = curl_init("${api}/delegate");
        curl_setopt_array($ch, [
            CURLOPT_POST           => true,
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_HTTPHEADER     => ['Content-Type: application/json'],
            CURLOPT_POSTFIELDS     => json_encode([
                'tx_hash'     => $txHash,
                'delegate_to' => $delegateTo,
                'signature'   => $signature,
            ]),
        ]);
        $result = json_decode(curl_exec($ch), true);
        curl_close($ch);

        if (!isset($result['error'])) return $result;
        if ($result['error'] !== 'payment_verification_failed')
            throw new Exception($result['message']);
        sleep(3);
    }
    throw new Exception('Transaction not found after retries');
}

// Usage
$result = rentEnergy($api, $txHash, 'TWalletThatNeedsEnergy');
echo "Delegated: " . $result['energy'] . " energy\n";
echo "Delegation tx: " . $result['delegations'][0]['tx'] . "\n";
echo "Ref: " . $result['ref'] . "\n";

# 1. Send TRX to TFqUiCu1JwLHHnBNeaaVKH7Csm4aA3YhZx
#    Pricing is linear at 16,250 energy per TRX.
#    Min 4 TRX (65,000 energy), max 1,000 TRX (16.25M energy).
#    (use your wallet or tronweb CLI)

# 2. Sign the message {tx_hash}:{delegate_to} (proves you are the sender)
#    (use tronWeb.trx.signMessageV2 in your code)

# 3. Claim delegation with tx hash + signature
curl -X POST https://api.tronnrg.com/delegate \
  -H "Content-Type: application/json" \
  -d '{
    "tx_hash":     "YOUR_PAYMENT_TX_HASH",
    "delegate_to": "TWalletThatNeedsEnergy",
    "signature":   "YOUR_SIGNATURE"
  }'

# Response includes delegations[].tx — the on-chain hash you can verify on TronScan

Qanday ishlaydi

To&#39;lov manzili

GET /supply

POST /delegate

GET /health

Xato kodlari

Refunds

To&#39;liq misol

To'lov manzili

To'liq misol