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.
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ă.
Programul dvs. întreabă API-ul cât costă pachetul de energie necesar în acest moment.
Programul dvs. creează o comandă și o plătește — trimițând TRX la adresa dată sau taxând soldul dvs. TronBid.
Î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.
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.
Trimiteți cantitatea și durata de energie. Primești price_trx înapoi și pentru câte secunde este blocat.
Destinatarul resursei: target_address. POST /orders (energy_amount, duration_minutes, idempotency_key, target_address, payment_mode: "onchain") → pay_address, amount_trx, expires_at.
Plătește TRX din orice portofel. Energy sau Bandwidth va ajunge la destinatarul indicat în comandă. Nu trebuie să selectezi un portofel de plată. Trimite suma exactă la adresa de plată afișată în această comandă înainte să expire. Nu reutiliza adresa de plată a unei comenzi anterioare. (amount_trx TRX → pay_address; expires_at)
Interogați starea la fiecare două secunde până când devine delegată. Asta înseamnă că energia este delegată portofelului - gata.
{
"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
}Scurte explicații ale cuvintelor folosite în această documentație.
Ce să pregătiți înainte de a vă face prima cerere.
Trimite mesajul @tronbid pe Telegram — vei primi o cheie legată de contul tău TronBid. Cererile nu vor trece fără el.
Decideți adresa (target_address) care are nevoie de energie. De obicei, este portofelul de pe care clienții tăi trimit USDT.
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.
Pentru în lanț — un portofel cu TRX de plătit. Pentru plata soldului — un cont TronBid finanțat și modul sold activat.
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ă.
https://tronbid.com/api/v2/quick-rentExistă 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”) | Plătește TRX din orice portofel. Energy sau Bandwidth va ajunge la destinatarul indicat în comandă. Nu trebuie să selectezi un portofel de plată. amount_trx TRX → pay_address |
balance | payment_mode: sold + activat pentru cheia dvs | Debitat din soldul dvs. TRX TronBid |
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):
curl -sS https://tronbid.com/api/public/quick-rent/skusPlătește TRX din orice portofel. Energy sau Bandwidth va ajunge la destinatarul indicat în comandă. Nu trebuie să selectezi un portofel de plată. POST /quote → POST /orders (target_address, payment_mode: "onchain") → amount_trx TRX → pay_address → GET /orders/:id. Trimite suma exactă la adresa de plată afișată în această comandă înainte să expire. Nu reutiliza adresa de plată a unei comenzi anterioare.
Alias vechi opțional pentru target_address; nu limitează portofelul folosit la plată.
Trimite suma exactă la adresa de plată afișată în această comandă înainte să expire. Nu reutiliza adresa de plată a unei comenzi anterioare.
{
"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..."
}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).
{
"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..."
}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) |
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.
Estimați de câtă energie are nevoie o adresă pentru un transfer. Transmite portofelul destinatarului și dacă deține deja USDT.
/api/v2/quick-rent/calculator| 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 |
{
"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}'Returnează prețul curent pentru un pachet: price_trx, availability, save_percent și cât timp este valabilă oferta (expires_in_sec).
/api/v2/quick-rent/quote| Parametru | Type | Descriere | Example |
|---|---|---|---|
energie_cantitate | int | Cantitatea de energie din catalogul activ | 131000 |
duration_minutes | int | Durata de închiriere din catalog | 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}'Plătește TRX din orice portofel. Energy sau Bandwidth va ajunge la destinatarul indicat în comandă. Nu trebuie să selectezi un portofel de plată. POST /orders (target_address, payment_mode: "onchain") → pay_address, amount_trx, expires_at.
Trimite suma exactă la adresa de plată afișată în această comandă înainte să expire. Nu reutiliza adresa de plată a unei comenzi anterioare.
/api/v2/quick-rent/orders| Parametru | Type | Descriere | Example |
|---|---|---|---|
energy_amount | int | Cantitatea de energie din catalog | 131000 |
duration_minutes | int | Durata de închiriere din catalog | 15 |
idempotency_key | string | Codul dvs. unic de comandă (8–128 de caractere) | partner-onchain-001 |
payment_mode | string | Opțional. „onchain” (implicit) sau „balance”. | balance |
payer_address | string | Alias vechi opțional pentru target_address; nu limitează portofelul folosit la plată. | TTarget... |
target_address | string | Destinatarul resursei. Plătește TRX din orice portofel. Energy sau Bandwidth va ajunge la destinatarul indicat în comandă. Nu trebuie să selectezi un portofel de plată. | 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..."
}'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.
/api/v2/quick-rent/orders/:id| Parametru | Type | Descriere | Example |
|---|---|---|---|
id | string | ID comandă (parametru cale) | 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"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ă.
/api/v2/quick-rent/orders/:id/cancel| Parametru | Type | Descriere | Example |
|---|---|---|---|
id | string | ID comandă (parametru cale) | uuid |
curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID/cancel" \
-H "Authorization: Bearer $API_KEY"Returnează soldul TRX al contului TronBid conectat la cheia dvs. API (soldul dvs. în aplicație, nu un portofel în lanț). Necesită antetul Autorizare.
/api/v2/quick-rent/balance{ "balance_trx": "150.500000" }curl -sS "$BASE_URL/api/v2/quick-rent/balance" \
-H "Authorization: Bearer $API_KEY"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 | Destinatarul resursei: pending_payment |
| 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 |
Situații obișnuite și ce trebuie făcut, în cuvinte simple.
Trimite suma exactă la adresa de plată afișată în această comandă înainte să expire. Nu reutiliza adresa de plată a unei comenzi anterioare. Plătește TRX din orice portofel. Energy sau Bandwidth va ajunge la destinatarul indicat în comandă. Nu trebuie să selectezi un portofel de plată. GET /orders/:id → status
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ă.
Destinatarul resursei: pending_payment. GET /orders/:id; POST /orders/:id/cancel; expires_at.
Plata soldului nu este activată pentru cheia dvs. Contactați asistența TronBid pentru a-l activa sau utilizați în lanț (implicit).
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.
Cu plată insuficientă/supraplată în lanț, suma finală se modifică. Verificați effective_energy_amount în GET /orders/:id — aceasta este energia delegată efectiv.
Aveți nevoie de acces API, de limite mai mari sau de activarea plății soldului? Luați legătura și vă vom ajuta.