API REST v2Documentație actualizată la 2 august 2026

TRON Energy Rental API — Automatizează transferurile USDT TRC-20

Integrați API v2 pentru a cota, crea și urmări în mod programatic comenzile de închiriere TRON Energy. Plătiți în lanț sau din soldul dvs. TronBid și reduceți TRX ars de apelurile smart-contract.

Cotații live și catalog de pachete
Plată în lanț sau sold
Comenzile idempotente și sondajul de stare

Obțineți acces la API Deschideți Quick Start Închiriez energie fără API Calculați cerințele energetice

Pe această pagină

TRON Energy Rental API: prezentare generală și cazuri de utilizare

API-ul Quick Rent este o modalitate de a închiria TRON Energy automat, fără muncă manuală. Energia face transferurile USDT (TRC-20) și alte apeluri smart-contract mai ieftine decât arderea TRX.

În cuvinte simple: programul dvs. (un site, un bot sau un serviciu) cumpără energie în sine, exact atunci când este nevoie - de exemplu, înainte de fiecare transfer USDT pe care îl face clientul dvs.

Gândiți-vă la un automat: verificați prețul, introduceți bani, obțineți articolul. API-ul este același set de butoane - doar programul dvs. le apasă.

1
Cere un pret
Programul dvs. întreabă API-ul cât costă pachetul de energie necesar în acest moment.
2
Creați o comandă și plătiți
Programul dvs. creează o comandă și o plătește — trimițând TRX la adresa dată sau taxând soldul dvs. TronBid.
3
Obțineți energia
În câteva secunde, energia apare pe portofelul țintă, iar USDT poate fi trimis mai ieftin.

Important: API-ul este un instrument pentru un dezvoltator. Pentru a-l folosi, cineva trebuie să scrie codul care trimite cererile.

Dacă nu există nimeni care să scrie codul - utilizați achiziția de energie gata făcută de pe site (Quick Rent) sau botul Telegram @tronbid. Același rezultat, doar făcut manual.

Pornire rapidă: de la zero la energie

Un exemplu complet de la capăt la capăt al celui mai simplu scenariu (on-chain). Patru pași și energie este pe portofel.

Mai jos este ce se întâmplă la fiecare pas și ce returnează API-ul. Introduceți cheia API, adresele și codul comenzii.

1
Pasul 1. Obțineți un preț — POST / cotație
Trimiteți cantitatea și durata de energie. Primești price_trx înapoi și pentru câte secunde este blocat.
2
Pasul 2. Creați o comandă — POST /comenzi
Trimiteți pachetul, cheia_idempotnței și adresa_plătitorului. Primești pay_address (unde să plătești), amount_trx (cât) și expires_at (până când).
3
Pasul 3. Plătiți
Trimite exact amount_trx TRX la pay_address de la payer_address. Este un simplu transfer TRON.
4
Pasul 4. Așteptați energie — GET /orders/:id
Interogați starea la fiecare două secunde până când devine delegată. Asta înseamnă că energia este delegată portofelului - gata.

Răspuns

json

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

Răspuns (în lanț)

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

Răspuns

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
}

Glosar

Scurte explicații ale cuvintelor folosite în această documentație.

Energie: „Combustibilul” rețelei TRON pentru operațiuni smart-contract. Dacă nu este suficient, rețeaua arde în schimb TRX - ceea ce este mai scump. Închirierea energiei economisește bani.
TRX: Moneda nativă a rețelei TRON. Plătește pentru închirierea energiei și taxele de rețea.
USDT TRC-20: O monedă stabilă (dolar) pe TRON. Trimiterea este un apel inteligent care are nevoie de energie.
cheie API: Parola dvs. secretă pentru acces la API. Trimis cu fiecare cerere. Păstrați-l doar pe server.
Punct final: O adresă specifică-„buton” al API-ului la care programul dvs. trimite o solicitare (de exemplu, /quote — obțineți un preț).
GET / POSTĂ: Tipuri de cereri. GET înseamnă „doar întreabă/citește datele”; POST înseamnă „efectuați o acțiune” (creați o comandă, calculați un preț).
Jeton de purtător: Cum transmiteți cheia API: antetul scrie Autorizare: Purtător YOUR_KEY.
Plată în lanț: Plata unei comenzi cu un transfer simplu TRX la adresa dată - funcționează imediat, nu trebuie activat.
Plata soldului: Plătiți prin încărcarea soldului contului dvs. TronBid. Mai rapid, dar trebuie activat mai întâi pentru cheia dvs.
Delegare: Predarea temporară a energiei închiriate către portofelul țintă pentru perioada de închiriere (de exemplu, 15 sau 60 de minute).
Sondaj: Se cere din nou starea comenzii periodic (la fiecare două secunde) până când devine delegată sau se termină cu o eroare.
cheie_idempotenta: Id-ul dvs. unic de comandă. Dacă o solicitare este trimisă de două ori, API-ul returnează aceeași comandă în loc să creeze una nouă - protecție împotriva plății duble.

Înainte de a începe

Ce să pregătiți înainte de a vă face prima cerere.

1
Obțineți o cheie API
Trimite mesajul @tronbid pe Telegram — vei primi o cheie legată de contul tău TronBid. Cererile nu vor trece fără el.
2
Aveți un portofel TRON țintă
Decideți adresa (target_address) care are nevoie de energie. De obicei, este portofelul de pe care clienții tăi trimit USDT.
3
Alege un pachet din catalog
Energia este vândută în pachete (de obicei 65000 sau 131000 energie pentru 15 sau 60 de minute). Obțineți lista live de la punctul final de catalog, nu este nevoie de autentificare.
4
Pregătiți plata
Pentru în lanț — un portofel cu TRX de plătit. Pentru plata soldului — un cont TronBid finanțat și modul sold activat.

Adresa URL de bază a API-ului de producție

API-ul Quick Rent permite serviciului dumneavoastră să închirieze TRON Energy automat, astfel încât transferurile USDT TRC-20 și alte apeluri smart-contract costă mai puțin decât arderea TRX.

Toate punctele finale au o singură adresă URL de bază.

Adresa URL de bază (producție)

http

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

Autorizare

Fiecare solicitare trebuie să includă cheia dvs. API ca simbol Bearer în antetul Autorizare.

Păstrați cheia doar pe partea serverului (backend, secrete CI). Nu-l expediați niciodată în codul frontend sau în depozite publice. Cheia este legată de un singur cont TronBid (portofelul setat atunci când a fost acordat accesul); plățile soldului pot trage numai din acel cont.

Dacă depășiți limita de rată, API-ul răspunde cu HTTP 429.

http

Authorization: Bearer <API_KEY>

Moduri de plată

Există două moduri de a plăti o comandă. On-chain este implicit și nu necesită configurare. Plata soldului este opțională și trebuie să fie activată pentru cheia dvs.

Fără activare, o solicitare cu payment_mode: sold returnează 403 BALANCE_PAYMENT_NOT_ENABLED. Pentru a-l activa, contactați asistența TronBid.

Mode	Cum se activează	Plata
`on-chain`	Implicit — omite payment_mode (sau „onchain”)	Trimiteți TRX la pay_address de la payer_address
`balance`	payment_mode: sold + activat pentru cheia dvs	Debitat din soldul dvs. TRX TronBid

Catalogul pachetelor

energy_amount și duration_minutes trebuie să se potrivească cu un pachet de închiriere rapidă activ - de obicei 65000 sau 131000 de energie și 15 sau 60 de minute.

Preluați catalogul curent oricând (nu este necesară o autorizare):

Obțineți catalogul activ (fără autentificare)

bash

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

Flux în lanț

Pasul 1 — POSTĂ /Citația pentru a afla prețul. Pasul 2 — POST /comenzi pentru a crea comanda și a primi adresa_pay, amount_trx și expires_at. Pasul 3 — trimite exact amount_trx TRX la pay_address de la payer_address. Pasul 4 — interogați GET /comenzi/:id până când statutul este delegat (sau eșuat / expirat / anulat).

target_address este opțional — dacă este omisă, energia este delegată către payer_address.

Este permisă o singură comandă deschisă în lanț (pending_payment) pentru fiecare adresă_plătitor la un moment dat; în caz contrar, primești 409 PENDING_PAYMENT_INTENT_EXISTS. La o plată sub/exces, energia finală poate diferi — verificați efectiv_energy_amount în GET /comenzi/:id.

Corpul cererii

json

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

Răspuns

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..."
}

Fluxul de echilibru

Pasul 1 — OBȚINE / sold pentru a verifica TRX. Pasul 2 — POSTĂ / cotație pentru preț. Pasul 3 — POST /comenzi cu payment_mode: sold pentru debit și începe delegarea. Pasul 4 — interogați GET /comenzi/:id până când este delegat (în cazul unei erori de delegare, acesta devine eșuat și TRX este rambursat în soldul dvs.).

payer_address nu este necesar — contul conectat la cheia dvs. API plătește. Energy_amount din răspuns poate fi mai mare decât SKU comandat (price-matrix bonus).

Corpul cererii

json

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

Răspuns

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..."
}

Starea comenzilor

Fiecare comandă trece prin aceste stări. Sondaj GET /orders/:id pentru a-l urma.

Status	Înțeles
`pending_payment`	Se așteaptă plata în lanț
`delegating`	Plata primită sau soldul debitat; delegare in curs
`delegated`	Energia delegată
`cancelled`	Anulat înainte de plată (în lanț)
`expired`	Fereastra de plată în lanț a trecut
`failed`	Eroare (pentru sold, TRX este rambursat)

Idempotenta

idempotency_key (8–128 de caractere) este un ID de comandă unic de partea dvs. Repetarea POST/comenzilor cu aceeași cheie (pentru același client API) returnează aceeași comandă cu „duplicat”: true.

Nu reutilizați o cheie idempotency_key în diferite moduri de plată (onchain vs sold) - care returnează 409 IDEMPOTENCY_PAYMENT_MODE_MISMATCH.

Calculați cerințele de închiriere TRON Energy

Estimați de câtă energie are nevoie o adresă pentru un transfer. Transmite portofelul destinatarului și dacă deține deja USDT.

POST/api/v2/quick-rent/calculator

Parametrii

Parametru	Type	Descriere	Example
`adresa_portofel`	string	Adresa TRON de analizat	`TXXXXXXXX...XXXX`
`are_usdt`	boolean \| null	Dacă destinatarul deține deja USDT (afectează energia). adevărat, fals sau omite.	`true`

Corpul cererii

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}'

Obțineți o cotație de închiriere TRON Energy

Returnează prețul curent pentru un pachet: price_trx, availability, save_percent și cât timp este valabilă oferta (expires_in_sec).

POST/api/v2/quick-rent/quote

Parametrii

Parametru	Type	Descriere	Example
`energie_cantitate`	int	Cantitatea de energie din catalogul activ	`131000`
`duration_minutes`	int	Durata de închiriere din catalog	`15`

Răspuns

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}'

Creați o comandă de închiriere TRON Energy

Creează o comandă de închiriere. Pentru on-chain, transmiteți payer_address și plătiți suma returnată_trx către pay_address. Pentru sold, adăugați payment_mode: sold și contul conectat este taxat imediat.

adresa_țintă este opțională (adresa_plătitorului este implicită). Ține cont de regulile 409: o comandă deschisă în lanț pentru fiecare plătitor și nicio delegație de închiriere rapidă activă deja pe țintă (ACTIVE_DELEGATION_EXISTS).

POST/api/v2/quick-rent/orders

Parametrii

Parametru	Type	Descriere	Example
`energie_cantitate`	int	Cantitatea de energie din catalog	`131000`
`duration_minutes`	int	Durata de închiriere din catalog	`15`
`cheie_idempotenta`	string	Codul dvs. unic de comandă (8–128 de caractere)	`partner-onchain-001`
`mod_plată`	string	Opțional. „onchain” (implicit) sau „balance”.	`balance`
`adresa_plătitorului`	string	On-chain: portofel care trimite TRX. Nu este necesar pentru echilibru.	`TPayer...`
`adresa_țintă`	string	Opțional. Portofel care primește energie (implicit la adresa_plătitorului).	`TTarget...`

Răspuns (în lanț)

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..."
}

Răspuns (sold)

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 (în lanț)

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 (sold)

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..."
  }'

Obțineți starea comenzii

Returnează starea curentă, modul_plată, sumele, adresele și codul_error / mesajul de eroare dacă ceva a eșuat. efectiv_energy_amount reflectă energia delegată reală după plată insuficientă/exces.

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

Parametrii

Parametru	Type	Descriere	Example
`id`	string	ID comandă (parametru cale)	`uuid`

Răspuns

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"

Anulează comanda

Anulează o comandă care este încă în așteptare_payment (numai în lanț). Odată ce energia a fost delegată, comanda nu mai poate fi anulată.

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

Parametrii

Parametru	Type	Descriere	Example
`id`	string	ID comandă (parametru cale)	`uuid`

cURL

bash

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

Schimbați plătitorul

Schimbă portofelul de plată pentru o comandă în lanț pending_payment — util dacă clientul decide să plătească dintr-un alt portofel înainte de a trimite TRX.

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

Parametrii

Parametru	Type	Descriere	Example
`id`	string	ID comandă (parametru cale)	`uuid`
`adresa_plătitorului`	string	Portofel nou cu plată	`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..."}'

Verificați soldul API TronBid

Returnează soldul TRX al contului TronBid conectat la cheia dvs. API (soldul dvs. în aplicație, nu un portofel în lanț). Necesită antetul Autorizare.

GET/api/v2/quick-rent/balance

Răspuns

json

{ "balance_trx": "150.500000" }

cURL

bash

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

Coduri de eroare

Erorile returnează o stare HTTP și un câmp de eroare. Iată cele pe care le puteți întâlni.

HTTP	error	Când
400	`Invalid body`	JSON sau câmpuri nevalide
400	`INVALID_SKU / SKU_INACTIVE`	Pachet indisponibil
400	`INVALID_PAYER_ADDRESS / INVALID_TARGET_ADDRESS`	Adresă TRON incorect
400	`INSUFFICIENT_BALANCE`	Nu este suficient TRX la echilibru (mod echilibru)
401	`Unauthorized`	Cheie API lipsă sau nevalidă
403	`BALANCE_PAYMENT_NOT_ENABLED`	Plata soldului nu este activată pentru cheia dvs
409	`PENDING_PAYMENT_INTENT_EXISTS`	O comandă deschisă în lanț există deja pentru acest plătitor
409	`ACTIVE_DELEGATION_EXISTS`	Target are deja o delegație de închiriere rapidă activă
409	`POOL_ENERGY_INSUFFICIENT`	Nu există energie gratuită pentru piscină în acest moment
409	`IDEMPOTENCY_PAYMENT_MODE_MISMATCH`	Aceeași idempotency_key cu un alt mod de plată
429	`Too Many Requests`	Limită de rată
503	`—`	Serviciul este temporar indisponibil, reîncercați mai târziu

Dacă ceva nu merge bine

Situații obișnuite și ce trebuie făcut, în cuvinte simple.

Am plătit, dar comanda este blocată în pending_payment

Asigurați-vă că suma transferată este exact egală cu amount_trx și că fondurile au ajuns la pay_address de la exact payer_address. Transferul trebuie să sosească înainte de expires_at. Starea se actualizează de obicei într-un minut după confirmarea rețelei - continuați să interogați GET /comenzi/:id.

Statutul a eșuat - ce este?

Delegarea nu a reușit. Pentru plățile soldului, TRX este returnat automat la soldul dvs. Motivul este în error_code și error_message din GET /orders/:id. Puteți crea o nouă comandă.

Eroare 409 PENDING_PAYMENT_INTENT_EXISTS

Această adresă_plătitor are deja o comandă neplătită în lanț. Plătiți-l, așteptați să expire (expires_at) sau anulați-l prin /orders/:id/cancel, apoi creați unul nou.

Eroare 403 BALANCE_PAYMENT_NOT_ENABLED

Plata soldului nu este activată pentru cheia dvs. Contactați asistența TronBid pentru a-l activa sau utilizați în lanț (implicit).

Eroare 429 Prea multe solicitări

Prea multe cereri într-un timp scurt. Reduceți frecvența de interogare (de exemplu, o dată la 3 secunde) și reîncercați mai târziu.

Am mai puțină energie decât am comandat

Cu plată insuficientă/supraplată în lanț, suma finală se modifică. Verificați effective_energy_amount în GET /orders/:id — aceasta este energia delegată efectiv.

Suport pentru integrarea TRON Energy API

Aveți nevoie de acces API, de limite mai mari sau de activarea plății soldului? Luați legătura și vă vom ajuta.

Acces API și plata solduluiTelegram @tronbid

E-mailsupport@tronbid.com