REST API v2Dokumentace aktualizována 2. srpna 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 TronBid a snižte počet TRX spálených hovory smart-contract.

Živé nabídky a katalog balíčku
Řetězová platba nebo platba zůstatku
Idempotentní příkazy a stavové průzkumy

Získejte přístup k API Otevřete Rychlý start Pronájem energie bez API Vypočítejte energetické požadavky

Na této stránce

TRON Energy Rental API: overview and use cases

The Quick Rent API is a way to rent TRON Energy automatically, with no manual work. Energy makes USDT (TRC-20) transfers and other smart-contract calls cheaper than burning 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.

Think of a vending machine: you check the price, insert money, get your item. The API is the same set of buttons — only your program presses them.

1
Zeptejte se na cenu
Your program asks the API how much the needed energy package costs right now.
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 TronBid.
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 kód napsal, použijte hotový nákup energie na webu (Quick Rent) nebo telegram bota @tronbid. Stejný výsledek, jen ručně.

Quickstart: from zero to energy

Ú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í. Plug in your API key, addresses and order id.

1
Step 1. Get a price — POST /quote
Send the energy amount and duration. You get price_trx back and how many seconds it's locked for.
2
Step 2. Create an order — POST /orders
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
Step 4. Wait for energy — GET /orders/:id
Dotazujte se na stav každých pár sekund, dokud nebude delegován. That means energy is delegated to the wallet — done.

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. Sending it is a smart-contract call that needs energy.
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 means "just ask / read data"; POST means "do an action" (create an order, calculate a price).
Token na doručitele: Jak předáte klíč API: hlavička zní Authorization: Bearer YOUR_KEY.
Řetězová platba: Paying an order with a plain TRX transfer to the given address — works right away, nothing to enable.
Platba zůstatku: Platba nabitím zůstatku na účtu TronBid. Rychlejší, ale musí být nejprve povoleno pro váš klíč.
delegování: Temporarily handing the rented energy to the target wallet for the rental period (e.g. 15 or 60 minutes).
Průzkum: Re-asking the order status periodically (every couple of seconds) until it becomes delegated or ends with an error.
idempotency_key: Vaše jedinečné ID objednávky. If a request is sent twice, the API returns the same order instead of creating a new one — protection against double payment.

Než začnete

What to prepare before making your first request.

1
Získejte klíč API
Odešlete zprávu @tronbid na telegramu – získáte klíč spojený s vaším účtem TronBid. Bez toho žádosti neprojdou.
2
Have a target TRON wallet
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
Pick a package from the catalog
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 TronBid 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.

All endpoints share one base URL.

Základní URL (produkce)

http

https://tronbid.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, tajemství CI). 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 TronBid (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

There are two ways to pay for an order. On-chain is the default and needs no setup. 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 TronBid.

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 TronBid TRX

Katalog balíčků

energy_amount and duration_minutes must match an active Quick Rent package — usually 65000 or 131000 energy and 15 or 60 minutes.

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

Get the active catalog (no auth)

bash

curl -sS https://tronbid.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).

target_address is optional — if omitted, energy is delegated to payer_address.

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. On under/overpayment the final energy may differ — check effective_energy_amount in 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. Step 3 — POST /orders with payment_mode: balance to debit and start delegation. Step 4 — poll GET /orders/:id until delegated (on a delegation error it becomes failed and TRX is refunded to your balance).

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://tronbid.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 409 pravidel: jedna otevřená on-chain objednávka na 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 se něco nezdaří. 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 před odesláním TRX zaplatit z jiné peněženky.

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 TronBid

Vrátí zůstatek TRX účtu TronBid 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`	Not enough TRX on balance (balance mode)
401	`Unauthorized`	Missing or invalid API key
403	`BALANCE_PAYMENT_NOT_ENABLED`	Balance payment not enabled for your key
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`	No free pool energy right now
409	`IDEMPOTENCY_PAYMENT_MODE_MISMATCH`	Stejný idempotency_key s jiným režimem platby
429	`Too Many Requests`	Limit sazby
503	`—`	Service temporarily unavailable, retry later

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 TronBid 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.

API access & balance paymentTelegram @tronbid

Emailsupport@tronbid.com