REST API v2Documentation updated August 2, 2026

TRON Energy Rental API — Automatizujte převody USDT TRC-20

Integrujte API v2 pro cenovou nabídku, vytváření a sledování objednávek pronájmu TRON Energy programově. Plaťte na řetězci nebo ze svého zůstatku Rent Energy Tron a snižte počet TRX spálených hovory smart-contract.

Live quotes and package catalog
On-chain or balance payment
Idempotent orders and status polling

Get API access Open Quick Start Pronájem energie bez API Calculate Energy requirements

Na této stránce

TRON Energy Rental API: přehled a případy použití

Quick Rent API je způsob, jak si TRON Energy pronajmout automaticky, bez ruční práce. Díky energii jsou převody USDT (TRC-20) a další hovory s inteligentními smlouvami levnější než vypalování TRX.

Jednoduše řečeno: váš program (web, robot nebo služba) nakupuje energii sám, přesně tehdy, když je potřeba – například před každým převodem USDT, který provede váš zákazník.

Představte si prodejní automat: zkontrolujete cenu, vložíte peníze a dostanete zboží. API je stejná sada tlačítek – stiskne je pouze váš program.

1
Zeptejte se na cenu
Váš program se zeptá API, kolik stojí potřebný energetický balíček právě teď.
2
Vytvořte objednávku a zaplaťte
Váš program vytvoří objednávku a zaplatí ji — zasláním TRX na zadanou adresu nebo nabitím vašeho zůstatku Rent Energy Tron.
3
Získejte energii
Během několika sekund se na cílové peněžence objeví energie a USDT lze poslat levněji.

Důležité: API je nástroj pro vývojáře. Chcete-li jej použít, někdo musí napsat kód, který odesílá požadavky.

Pokud není nikdo, kdo by napsal kód, použijte hotový nákup energie na webu (Quick Rent) nebo telegram bot @rentenergytroncom. Stejný výsledek, jen ručně.

Rychlý start: od nuly k energii

Úplný end-to-end příklad na nejjednodušším scénáři (on-chain). Čtyři kroky a energie je v peněžence.

Níže je uvedeno, co se děje v každém kroku a co rozhraní API vrací. Zapojte svůj API klíč, adresy a ID objednávky.

1
Krok 1. Získejte cenu — POST/nabídka
Pošlete množství energie a dobu trvání. Dostanete price_trx zpět a na kolik sekund je uzamčen.
2
Krok 2. Vytvořte objednávku — POST /objednávky
Odešlete balíček, váš idempotency_key a payer_address. Získáte pay_address (kde zaplatit), sum_trx (kolik) a expires_at (do kdy).
3
Krok 3. Zaplaťte
Odešlete přesně částku_trx TRX na pay_address z vaší payer_address. Je to obyčejný TRON převod.
4
Krok 4. Počkejte na energii — GET /objednávky/:id
Dotazujte se na stav každých pár sekund, dokud nebude delegován. To znamená, že energie je přenesena do peněženky – hotovo.

Odezva

json

{
  "price_trx": "3.200000",
  "available": true,
  "save_percent": 62,
  "expires_in_sec": 30
}

Odezva (v řetězci)

json

{
  "id": "uuid",
  "status": "pending_payment",
  "payment_mode": "onchain",
  "pay_address": "TDeposit...",
  "amount_trx": "3.200000",
  "energy_amount": 131000,
  "duration_minutes": 15,
  "expires_at": "2026-04-29T13:15:00.000Z",
  "qr_payload": "tron:TDeposit...?amount=3.200000",
  "duplicate": false,
  "target_address": "TTarget..."
}

cURL

bash

# poll every 3s until the order is done
while true; do
  STATUS=$(curl -sS "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID" \
    -H "Authorization: Bearer $API_KEY" | jq -r .status)
  echo "status: $STATUS"
  case "$STATUS" in
    delegated|failed|expired|cancelled) break ;;
  esac
  sleep 3
done

Odezva

json

{
  "id": "uuid",
  "status": "delegated",
  "payment_mode": "onchain",
  "amount_trx": "3.200000",
  "energy_amount": 131000,
  "effective_energy_amount": 131000,
  "duration_minutes": 15,
  "pay_address": "TDeposit...",
  "payer_address": "TPayer...",
  "target_address": "TTarget...",
  "error_code": null,
  "error_message": null
}

Glosář

Krátká vysvětlení slov použitých v této dokumentaci.

Energie: „Palivo“ sítě TRON pro operace smart-contract. Pokud není dostatek, síť místo toho vypálí TRX — což je dražší. Pronájem energií šetří peníze.
TRX: Nativní mince sítě TRON. Platí za nájem energií a poplatky za sítě.
USDT TRC-20: Stabilní coin (dolar) na TRON. Odeslání je hovor s inteligentní smlouvou, který potřebuje energii.
API klíč: Vaše tajné heslo pro přístup k API. Odesláno s každou žádostí. Udržujte jej pouze na serveru.
Koncový bod: Konkrétní adresa – „tlačítko“ rozhraní API, kam váš program odešle požadavek (např. /quote – získat cenu).
ZÍSKEJTE / ZVEŘEJTE: Typy požadavků. GET znamená "jen požádat / přečíst data"; POST znamená „provést akci“ (vytvořit objednávku, vypočítat cenu).
Token na doručitele: Jak předáte klíč API: hlavička zní Authorization: Bearer YOUR_KEY.
Řetězová platba: Zaplacení objednávky prostým převodem TRX na danou adresu — funguje hned, nic k povolení.
Platba zůstatku: Platba nabitím zůstatku na účtu Rent Energy Tron. Rychlejší, ale musí být nejprve povoleno pro váš klíč.
delegování: Dočasné předání pronajaté energie do cílové peněženky po dobu pronájmu (např. 15 nebo 60 minut).
Průzkum: Opakované dotazování na stav objednávky pravidelně (každých pár sekund), dokud nebude delegována nebo skončí chybou.
idempotency_key: Vaše jedinečné ID objednávky. Pokud je požadavek odeslán dvakrát, API vrátí stejnou objednávku namísto vytvoření nové — ochrana proti dvojí platbě.

Než začnete

Co si připravit před podáním první žádosti.

1
Získejte klíč API
Odešlete zprávu @rentenergytroncom na Telegram — získáte klíč spojený s vaším účtem Rent Energy Tron. Bez toho žádosti neprojdou.
2
Mít cílovou peněženku TRON
Rozhodněte se o adrese (cílová_adresa), která potřebuje energii. Obvykle je to peněženka, ze které vaši zákazníci posílají USDT.
3
Vyberte si balíček z katalogu
Energie se prodává v balíčcích (obvykle 65000 nebo 131000 energie na 15 nebo 60 minut). Získejte živý seznam z koncového bodu katalogu, není potřeba žádné ověření.
4
Připravte platbu
Pro on-chain — peněženka s TRX k platbě. Pro platbu zůstatku — financovaný účet Rent Energy Tron a aktivovaný režim zůstatku.

Základní URL produkčního rozhraní API

Quick Rent API umožňuje vaší službě automaticky pronajmout TRON Energy, takže převody USDT TRC-20 a další hovory s chytrými smlouvami stojí méně než vypalování TRX.

Všechny koncové body sdílejí jednu základní adresu URL.

Základní URL (produkce)

http

https://rentenergytron.com/api/v2/quick-rent

Autorizace

Každý požadavek musí obsahovat váš klíč API jako token nosiče v hlavičce Autorizace.

Udržujte klíč pouze na straně serveru (backend, CI tajemství). Nikdy jej neposílejte v kódu frontendu nebo ve veřejných úložištích. Klíč je vázán na jeden účet Rent Energy Tron (peněženka nastavená při udělení přístupu); platby zůstatku lze čerpat pouze z tohoto účtu.

Pokud překročíte limit rychlosti, rozhraní API odpoví HTTP 429.

http

Authorization: Bearer <API_KEY>

Platební režimy

Za objednávku lze zaplatit dvěma způsoby. On-chain je výchozí a nevyžaduje žádné nastavení. Platba zůstatku je volitelná a musí být povolena pro váš klíč.

Bez aktivace se požadavek s payment_mode: balance vrátí 403 BALANCE_PAYMENT_NOT_ENABLED. Chcete-li jej povolit, kontaktujte podporu Rent Energy Tron.

Mode	Jak povolit	Platba
`on-chain`	Výchozí — vynechat payment_mode (nebo „onchain“)	Odešlete TRX na pay_address z payer_address
`balance`	payment_mode: zůstatek + povolen pro váš klíč	Odečteno z vašeho zůstatku Rent Energy Tron TRX

Katalog balíčků

množství energie a doba trvání_minut musí odpovídat aktivnímu balíčku rychlého pronájmu – obvykle 65 000 nebo 131 000 energie a 15 nebo 60 minut.

Načíst aktuální katalog kdykoli (nevyžaduje se žádné ověření):

Získejte aktivní katalog (bez ověření)

bash

curl -sS https://rentenergytron.com/api/public/quick-rent/skus

Průtok na řetězu

Krok 1 — ZVEŘEJTE/nabídněte, abyste zjistili cenu. Krok 2 — POST/objednávky pro vytvoření objednávky a obdržení pay_address, value_trx a expires_at. Krok 3 — Odešlete přesně částku_trx TRX na pay_address z vaší payer_address. Krok 4 — dotazování GET /orders/:id, dokud není stav delegován (nebo neúspěšný / vypršela / zrušena).

cílová_adresa je volitelná — pokud se vynechá, energie je delegována na adresu plátce.

Vždy je povolena pouze jedna otevřená řetězová objednávka (čekající_platba) na adresu plátce; jinak získáte 409 PENDING_PAYMENT_INTENT_EXISTS. Při nedoplatku/přeplatku se konečná energie může lišit — zkontrolujte efektivní_částku_energie v GET /orders/:id.

Tělo žádosti

json

{
  "energy_amount": 131000,
  "duration_minutes": 15,
  "idempotency_key": "your-unique-key-001",
  "payer_address": "TPayerWalletXXXXXXXXXXXXXXXXXXXXXX",
  "target_address": "TTargetWalletXXXXXXXXXXXXXXXXXXXXX"
}

Odezva

json

{
  "id": "uuid",
  "status": "pending_payment",
  "payment_mode": "onchain",
  "pay_address": "TDeposit...",
  "amount_trx": "3.200000",
  "energy_amount": 131000,
  "duration_minutes": 15,
  "expires_at": "2026-04-29T13:15:00.000Z",
  "qr_payload": "tron:TDeposit...?amount=3.200000",
  "duplicate": false,
  "target_address": "TTarget..."
}

Rovnováha průtoku

Krok 1 — ZÍSKEJTE/BALANCE pro kontrolu TRX. Krok 2 — POST/nabídka ceny. Krok 3 — POST / objednávky s režimem platby: zůstatek k debetu a zahájení delegování. Krok 4 — dotazování GET /orders/:id až do delegování (při chybě delegování se to nezdaří a TRX je vráceno na váš zůstatek).

payer_address není potřeba – platí účet propojený s vaším API klíčem. Částka energie v odpovědi může být vyšší než objednané SKU (price-matrix bonus).

Tělo žádosti

json

{
  "energy_amount": 131000,
  "duration_minutes": 15,
  "idempotency_key": "your-unique-key-balance-001",
  "payment_mode": "balance",
  "target_address": "TTargetWalletXXXXXXXXXXXXXXXXXXXXX"
}

Odezva

json

{
  "id": "uuid",
  "status": "delegating",
  "payment_mode": "balance",
  "pay_address": null,
  "amount_trx": "3.200000",
  "energy_amount": 132310,
  "duration_minutes": 15,
  "expires_at": null,
  "qr_payload": null,
  "duplicate": false,
  "target_address": "TTarget..."
}

Stavy objednávek

Každá objednávka prochází těmito stavy. Průzkum GET /orders/:id jej následuje.

Status	Význam
`pending_payment`	Čekání na platbu v řetězci
`delegating`	Přijatá platba nebo naúčtovaný zůstatek; probíhá delegace
`delegated`	Energie delegovaná
`cancelled`	Zrušeno před platbou (v řetězci)
`expired`	Uplynulo okno pro platbu v řetězci
`failed`	Chyba (pro zůstatek, TRX je vrácena)

Idempotence

idempotency_key (8–128 znaků) je jedinečné ID objednávky na vaší straně. Opakování POST /objednávek se stejným klíčem (pro stejného klienta API) vrátí stejnou objednávku s "duplikovat": true.

Nepoužívejte znovu jeden idempotency_key v různých platebních režimech (onchain vs. zůstatek) – vrátí 409 IDEMPOTENCY_PAYMENT_MODE_MISMATCH.

Vypočítejte požadavky na pronájem TRON Energy

Odhadněte, kolik energie adresa potřebuje pro přenos. Předejte peněženku příjemce a zda již drží USDT.

POST/api/v2/quick-rent/calculator

Parametry

Parametr	Type	Popis	Example
`adresa_peněženky`	string	Adresa TRON k analýze	`TXXXXXXXX...XXXX`
`has_usdt`	boolean \| null	Zda příjemce již vlastní USDT (ovlivňuje energii). pravda, nepravda nebo vynechání.	`true`

Tělo žádosti

json

{
  "wallet_address": "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "has_usdt": true
}

cURL

bash

curl -sS -X POST "$BASE_URL/api/v2/quick-rent/calculator" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"wallet_address":"TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX","has_usdt":true}'

Získejte nabídku pronájmu TRON Energy

Vrátí aktuální cenu za balíček: price_trx, dostupnost, save_percent a jak dlouho je nabídka platná (expires_in_sec).

POST/api/v2/quick-rent/quote

Parametry

Parametr	Type	Popis	Example
`množství_energie`	int	Množství energie z aktivního katalogu	`131000`
`trvání_minuty`	int	Doba pronájmu z katalogu	`15`

Odezva

json

{
  "price_trx": "3.200000",
  "available": true,
  "save_percent": 62,
  "expires_in_sec": 30
}

cURL

bash

export BASE_URL="https://rentenergytron.com"
export API_KEY="your_api_key"

curl -sS -X POST "$BASE_URL/api/v2/quick-rent/quote" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"energy_amount":131000,"duration_minutes":15}'

Vytvořte objednávku pronájmu TRON Energy

Vytvoří objednávku pronájmu. Pro on-chain předejte payer_address a zaplaťte vrácenou částku_trx na pay_address. Pro zůstatek přidejte payment_mode: balance a propojený účet bude okamžitě účtován.

cílová_adresa je volitelná (výchozí je adresa plátce). Pamatujte na pravidla 409: jedna otevřená objednávka v řetězci na jednoho plátce a žádné aktivní delegování rychlého pronájmu již v cíli (ACTIVE_DELEGATION_EXISTS).

POST/api/v2/quick-rent/orders

Parametry

Parametr	Type	Popis	Example
`množství_energie`	int	Množství energie z katalogu	`131000`
`trvání_minuty`	int	Doba pronájmu z katalogu	`15`
`idempotency_key`	string	Vaše jedinečné ID objednávky (8–128 znaků)	`partner-onchain-001`
`platební_režim`	string	Volitelné. "onchain" (výchozí) nebo "balance".	`balance`
`adresa_plátce`	string	On-chain: peněženka, která posílá TRX. Není potřeba pro rovnováhu.	`TPayer...`
`cílová_adresa`	string	Volitelné. Peněženka, která přijímá energii (výchozí nastavení je adresa_platiče).	`TTarget...`

Odezva (v řetězci)

json

{
  "id": "uuid",
  "status": "pending_payment",
  "payment_mode": "onchain",
  "pay_address": "TDeposit...",
  "amount_trx": "3.200000",
  "energy_amount": 131000,
  "duration_minutes": 15,
  "expires_at": "2026-04-29T13:15:00.000Z",
  "qr_payload": "tron:TDeposit...?amount=3.200000",
  "duplicate": false,
  "target_address": "TTarget..."
}

Odezva (zůstatek)

json

{
  "id": "uuid",
  "status": "delegating",
  "payment_mode": "balance",
  "pay_address": null,
  "amount_trx": "3.200000",
  "energy_amount": 132310,
  "duration_minutes": 15,
  "expires_at": null,
  "qr_payload": null,
  "duplicate": false,
  "target_address": "TTarget..."
}

cURL (on-chain)

bash

curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "energy_amount": 131000,
    "duration_minutes": 15,
    "idempotency_key": "partner-onchain-001",
    "payer_address": "TPayer...",
    "target_address": "TTarget..."
  }'

cURL (zůstatek)

bash

curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "energy_amount": 131000,
    "duration_minutes": 15,
    "idempotency_key": "partner-balance-001",
    "payment_mode": "balance",
    "target_address": "TTarget..."
  }'

Získejte stav objednávky

Vrátí aktuální stav, režim platby, částky, adresy a chybový_kód / chybovou_zprávu, pokud něco selhalo. efektivní_částka_energie odráží skutečnou delegovanou energii po pod/přeplatku.

GET/api/v2/quick-rent/orders/:id

Parametry

Parametr	Type	Popis	Example
`id`	string	ID objednávky (parametr cesty)	`uuid`

Odezva

json

{
  "id": "uuid",
  "status": "delegated",
  "payment_mode": "onchain",
  "amount_trx": "3.200000",
  "energy_amount": 131000,
  "effective_energy_amount": 131000,
  "duration_minutes": 15,
  "pay_address": "TDeposit...",
  "payer_address": "TPayer...",
  "target_address": "TTarget...",
  "error_code": null,
  "error_message": null
}

cURL

bash

curl -sS "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID" \
  -H "Authorization: Bearer $API_KEY"

Zrušit objednávku

Zruší objednávku, která stále čeká na platbu (pouze v řetězci). Po delegování energie již objednávku nelze zrušit.

POST/api/v2/quick-rent/orders/:id/cancel

Parametry

Parametr	Type	Popis	Example
`id`	string	ID objednávky (parametr cesty)	`uuid`

cURL

bash

curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID/cancel" \
  -H "Authorization: Bearer $API_KEY"

Změnit plátce

Změní platební peněženku pro nevyřízenou platbu v řetězci – užitečné, pokud se zákazník rozhodne zaplatit z jiné peněženky před odesláním TRX.

POST/api/v2/quick-rent/orders/:id/set-payer

Parametry

Parametr	Type	Popis	Example
`id`	string	ID objednávky (parametr cesty)	`uuid`
`adresa_plátce`	string	Nová platební peněženka	`TNewPayer...`

cURL

bash

curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID/set-payer" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"payer_address":"TNewPayer..."}'

Zkontrolujte zůstatek rozhraní API Rent Energy Tron

Vrátí zůstatek TRX účtu Rent Energy Tron propojeného s vaším klíčem API (váš zůstatek v aplikaci, nikoli peněženka v řetězci). Vyžaduje záhlaví Authorization.

GET/api/v2/quick-rent/balance

Odezva

json

{ "balance_trx": "150.500000" }

cURL

bash

curl -sS "$BASE_URL/api/v2/quick-rent/balance" \
  -H "Authorization: Bearer $API_KEY"

Chybové kódy

Chyby vrátí stav HTTP a pole chyby. Zde jsou ty, se kterými se můžete setkat.

HTTP	error	Kdy
400	`Invalid body`	Neplatný JSON nebo pole
400	`INVALID_SKU / SKU_INACTIVE`	Balíček není k dispozici
400	`INVALID_PAYER_ADDRESS / INVALID_TARGET_ADDRESS`	Chybná adresa TRON
400	`INSUFFICIENT_BALANCE`	Nedostatek TRX na vyvážení (režim vyvážení)
401	`Unauthorized`	Chybějící nebo neplatný klíč API
403	`BALANCE_PAYMENT_NOT_ENABLED`	Platba zůstatku pro váš klíč není povolena
409	`PENDING_PAYMENT_INTENT_EXISTS`	Pro tohoto plátce již existuje otevřená objednávka v řetězci
409	`ACTIVE_DELEGATION_EXISTS`	Target již má aktivní delegování Quick Rent
409	`POOL_ENERGY_INSUFFICIENT`	Momentálně žádná bezplatná energie z bazénu
409	`IDEMPOTENCY_PAYMENT_MODE_MISMATCH`	Stejný idempotency_key s jiným režimem platby
429	`Too Many Requests`	Limit sazby
503	`—`	Služba je dočasně nedostupná, zkuste to znovu později

Pokud se něco pokazí

Běžné situace a co dělat, jednoduše řečeno.

Zaplatil jsem, ale objednávka se zasekla v čekající_platbě

Ujistěte se, že převáděná částka se přesně rovná částka_trx a že prostředky šly na pay_address z přesné payer_address. Převod musí dorazit před expires_at. Stav se obvykle aktualizuje do minuty po potvrzení sítě — pokračujte v dotazování GET /orders/:id.

Stav se stal neúspěšným – co to je?

Delegace neuspěla. Pro platby zůstatku se TRX automaticky vrátí k vašemu zůstatku. Důvod je v error_code a error_message GET /orders/:id. Můžete vytvořit novou objednávku.

Chyba 409 PENDING_PAYMENT_INTENT_EXISTS

Tato adresa_platiče již má nezaplacenou objednávku v řetězci. Zaplaťte ji, počkejte, až vyprší (expires_at), nebo ji zrušte přes /orders/:id/cancel a poté vytvořte novou.

Chyba 403 BALANCE_PAYMENT_NOT_ENABLED

Pro váš klíč není povolena platba zůstatku. Chcete-li jej aktivovat, kontaktujte podporu Rent Energy Tron nebo použijte on-chain (výchozí).

Chyba 429 Příliš mnoho požadavků

Příliš mnoho požadavků v krátkém čase. Snižte frekvenci dotazování (např. jednou za 3 sekundy) a opakujte později.

Dostal jsem méně energie, než jsem si objednal

S nedoplatkem/přeplatkem na řetězci se konečná částka změní. Zkontrolujte efektivní_množství_energie v GET /orders/:id — to je skutečně delegovaná energie.

Podpora integrace TRON Energy API

Potřebujete přístup k rozhraní API, vyšší limity nebo povolenou platbu zůstatku? Ozvěte se a my vám pomůžeme.

Přístup k API a platba zůstatkuTelegram @rentenergytroncom