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.
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.
Your program asks the API how much the needed energy package costs right now.
Váš program vytvoří objednávku a zaplatí ji — zasláním TRX na zadanou adresu nebo nabitím vašeho zůstatku TronBid.
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ě.
Ú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.
Send the energy amount and duration. You get price_trx back and how many seconds it's locked for.
Příjemce zdroje: target_address. POST /orders (energy_amount, duration_minutes, idempotency_key, target_address, payment_mode: "onchain") → pay_address, amount_trx, expires_at.
Zaplaťte TRX z libovolné peněženky. Energy nebo Bandwidth obdrží příjemce uvedený v objednávce. Platební peněženku není nutné vybírat. Před vypršením objednávky odešlete přesnou částku na platební adresu uvedenou v této objednávce. Nepoužívejte znovu platební adresu předchozí objednávky. (amount_trx TRX → pay_address; expires_at)
Dotazujte se na stav každých pár sekund, dokud nebude delegován. That means energy is delegated to the wallet — done.
{
"price_trx": "3.200000",
"available": true,
"save_percent": 62,
"expires_in_sec": 30
}{
"id": "uuid",
"status": "pending_payment",
"payment_sender_mode": "any_wallet",
"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..."
}# 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{
"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
}Krátká vysvětlení slov použitých v této dokumentaci.
What to prepare before making your first request.
Odešlete zprávu @tronbid na telegramu – získáte klíč spojený s vaším účtem TronBid. Bez toho žádosti neprojdou.
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.
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í.
Pro on-chain — peněženka s TRX k platbě. Pro platbu zůstatku — financovaný účet TronBid a aktivovaný režim zůstatku.
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.
https://tronbid.com/api/v2/quick-rentThere 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“) | Zaplaťte TRX z libovolné peněženky. Energy nebo Bandwidth obdrží příjemce uvedený v objednávce. Platební peněženku není nutné vybírat. amount_trx TRX → pay_address |
balance | payment_mode: zůstatek + povolen pro váš klíč | Odečteno z vašeho zůstatku TronBid TRX |
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í):
curl -sS https://tronbid.com/api/public/quick-rent/skusZaplaťte TRX z libovolné peněženky. Energy nebo Bandwidth obdrží příjemce uvedený v objednávce. Platební peněženku není nutné vybírat. POST /quote → POST /orders (target_address, payment_mode: "onchain") → amount_trx TRX → pay_address → GET /orders/:id. Před vypršením objednávky odešlete přesnou částku na platební adresu uvedenou v této objednávce. Nepoužívejte znovu platební adresu předchozí objednávky.
Volitelný zastaralý alias pro target_address; neomezuje peněženku použitou k platbě.
Před vypršením objednávky odešlete přesnou částku na platební adresu uvedenou v této objednávce. Nepoužívejte znovu platební adresu předchozí objednávky.
{
"energy_amount": 131000,
"duration_minutes": 15,
"idempotency_key": "your-unique-key-001",
"payment_mode": "onchain",
"target_address": "TTargetWalletXXXXXXXXXXXXXXXXXXXXX"
}{
"id": "uuid",
"status": "pending_payment",
"payment_sender_mode": "any_wallet",
"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..."
}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).
{
"energy_amount": 131000,
"duration_minutes": 15,
"idempotency_key": "your-unique-key-balance-001",
"payment_mode": "balance",
"target_address": "TTargetWalletXXXXXXXXXXXXXXXXXXXXX"
}{
"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..."
}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) |
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.
Odhadněte, kolik energie adresa potřebuje pro přenos. Předejte peněženku příjemce a zda již drží USDT.
/api/v2/quick-rent/calculator| 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 |
{
"wallet_address": "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"has_usdt": true
}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}'Vrátí aktuální cenu za balíček: price_trx, dostupnost, save_percent a jak dlouho je nabídka platná (expires_in_sec).
/api/v2/quick-rent/quote| 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 |
{
"price_trx": "3.200000",
"available": true,
"save_percent": 62,
"expires_in_sec": 30
}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}'Zaplaťte TRX z libovolné peněženky. Energy nebo Bandwidth obdrží příjemce uvedený v objednávce. Platební peněženku není nutné vybírat. POST /orders (target_address, payment_mode: "onchain") → pay_address, amount_trx, expires_at.
Před vypršením objednávky odešlete přesnou částku na platební adresu uvedenou v této objednávce. Nepoužívejte znovu platební adresu předchozí objednávky.
/api/v2/quick-rent/orders| Parametr | Type | Popis | Example |
|---|---|---|---|
energy_amount | int | Množství energie z katalogu | 131000 |
duration_minutes | int | Doba pronájmu z katalogu | 15 |
idempotency_key | string | Vaše jedinečné ID objednávky (8–128 znaků) | partner-onchain-001 |
payment_mode | string | Volitelné. "onchain" (výchozí) nebo "balance". | balance |
payer_address | string | Volitelný zastaralý alias pro target_address; neomezuje peněženku použitou k platbě. | TTarget... |
target_address | string | Příjemce zdroje. Zaplaťte TRX z libovolné peněženky. Energy nebo Bandwidth obdrží příjemce uvedený v objednávce. Platební peněženku není nutné vybírat. | TTarget... |
{
"id": "uuid",
"status": "pending_payment",
"payment_sender_mode": "any_wallet",
"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..."
}{
"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 -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",
"payment_mode": "onchain",
"target_address": "TTarget..."
}'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..."
}'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.
/api/v2/quick-rent/orders/:id| Parametr | Type | Popis | Example |
|---|---|---|---|
id | string | ID objednávky (parametr cesty) | uuid |
{
"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 -sS "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID" \
-H "Authorization: Bearer $API_KEY"Zruší objednávku, která stále čeká na platbu (pouze v řetězci). Po delegování energie již objednávku nelze zrušit.
/api/v2/quick-rent/orders/:id/cancel| Parametr | Type | Popis | Example |
|---|---|---|---|
id | string | ID objednávky (parametr cesty) | uuid |
curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID/cancel" \
-H "Authorization: Bearer $API_KEY"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.
/api/v2/quick-rent/balance{ "balance_trx": "150.500000" }curl -sS "$BASE_URL/api/v2/quick-rent/balance" \
-H "Authorization: Bearer $API_KEY"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 | Příjemce zdroje: pending_payment |
| 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 |
Běžné situace a co dělat, jednoduše řečeno.
Před vypršením objednávky odešlete přesnou částku na platební adresu uvedenou v této objednávce. Nepoužívejte znovu platební adresu předchozí objednávky. Zaplaťte TRX z libovolné peněženky. Energy nebo Bandwidth obdrží příjemce uvedený v objednávce. Platební peněženku není nutné vybírat. GET /orders/:id → status
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.
Příjemce zdroje: pending_payment. GET /orders/:id; POST /orders/:id/cancel; expires_at.
Pro váš klíč není povolena platba zůstatku. Chcete-li jej aktivovat, kontaktujte podporu TronBid nebo použijte on-chain (výchozí).
Příliš mnoho požadavků v krátkém čase. Snižte frekvenci dotazování (např. jednou za 3 sekundy) a opakujte později.
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.
Potřebujete přístup k rozhraní API, vyšší limity nebo povolenou platbu zůstatku? Ozvěte se a my vám pomůžeme.