Integra l'API v2 per quotare, creare e monitorare gli ordini di noleggio di TRON Energy in modo programmatico. Paga on-chain o dal tuo saldo TronBid e riduci i TRX bruciati dalle chiamate con contratto intelligente.
L'API Quick Rent è un modo per noleggiare TRON Energy automaticamente, senza lavoro manuale. L'energia rende i trasferimenti USDT (TRC-20) e altre chiamate di contratti intelligenti più economici rispetto alla masterizzazione di TRX.
In parole povere: il tuo programma (un sito, un bot o un servizio) acquista energia da solo, esattamente quando è necessario, ad esempio prima di ogni trasferimento USDT effettuato dal tuo cliente.
Pensa a un distributore automatico: controlli il prezzo, inserisci i soldi, ricevi il tuo articolo. L'API è lo stesso insieme di pulsanti: solo il tuo programma li preme.
Il tuo programma chiede all'API quanto costa il pacchetto energetico necessario in questo momento.
Il tuo programma crea un ordine e lo paga, inviando TRX all'indirizzo indicato o addebitando il tuo saldo TronBid.
Nel giro di pochi secondi l'energia appare sul portafoglio di destinazione e gli USDT possono essere inviati a un prezzo inferiore.
Importante: l'API è uno strumento per uno sviluppatore. Per usarlo, qualcuno deve scrivere il codice che invia le richieste.
Se non c'è nessuno che scriva il codice, usa l'acquisto di energia già pronto sul sito (Quick Rent) o il bot di Telegram @tronbid. Stesso risultato, ma fatto manualmente.
Un esempio end-to-end completo sullo scenario più semplice (on-chain). Quattro passi e l'energia è nel portafoglio.
Di seguito è riportato cosa succede in ogni passaggio e cosa restituisce l'API. Inserisci la chiave API, gli indirizzi e l'ID dell'ordine.
Invia la quantità di energia e la durata. Ottieni indietro price_trx e per quanti secondi è bloccato.
Destinatario della risorsa: target_address. POST /orders (energy_amount, duration_minutes, idempotency_key, target_address, payment_mode: "onchain") → pay_address, amount_trx, expires_at.
Paga TRX da qualsiasi wallet. L’Energy o il Bandwidth verrà inviato al destinatario indicato nell’ordine. Non è necessario selezionare un wallet di pagamento. Invia l’importo esatto all’indirizzo di pagamento di questo ordine prima della scadenza. Non riutilizzare l’indirizzo di pagamento di un ordine precedente. (amount_trx TRX → pay_address; expires_at)
Esegui il polling sullo stato ogni paio di secondi finché non viene delegato. Ciò significa che l’energia è delegata al portafoglio: fatto.
{
"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
}Brevi spiegazioni delle parole utilizzate in questa documentazione.
Cosa preparare prima di fare la prima richiesta.
Invia un messaggio a @tronbid su Telegram: riceverai una chiave associata al tuo account TronBid. Le richieste non passeranno senza di essa.
Decidi l'indirizzo (target_address) che necessita di energia. Di solito è il portafoglio da cui i tuoi clienti inviano USDT.
L'energia viene venduta in pacchetti (solitamente 65000 o 131000 energia per 15 o 60 minuti). Ottieni l'elenco attivo dall'endpoint del catalogo, senza bisogno di autenticazione.
Per on-chain: un portafoglio con TRX per pagare. Per il pagamento del saldo: un conto TronBid finanziato e la modalità saldo abilitata.
L'API Quick Rent consente al tuo servizio di noleggiare TRON Energy automaticamente, quindi i trasferimenti USDT TRC-20 e altre chiamate con contratto intelligente costano meno della masterizzazione di TRX.
Tutti gli endpoint condividono un URL di base.
https://tronbid.com/api/v2/quick-rentEsistono due modi per pagare un ordine. On-chain è l'impostazione predefinita e non necessita di configurazione. Il pagamento del saldo è facoltativo e deve essere abilitato per la tua chiave.
Senza attivazione, una richiesta con payment_mode: balance restituisce 403 BALANCE_PAYMENT_NOT_ENABLED. Per abilitarlo, contattare il supporto TronBid.
| Mode | Come abilitare | Pagamento |
|---|---|---|
on-chain | Predefinito: ometti payment_mode (o "onchain") | Paga TRX da qualsiasi wallet. L’Energy o il Bandwidth verrà inviato al destinatario indicato nell’ordine. Non è necessario selezionare un wallet di pagamento. amount_trx TRX → pay_address |
balance | payment_mode: saldo + abilitato per la tua chiave | Addebitato sul tuo saldo TronBid TRX |
Energy_Amount e Duration_Minuti devono corrispondere a un pacchetto Quick Rent attivo, in genere 65.000 o 131.000 energia e 15 o 60 minuti.
Recupera il catalogo corrente in qualsiasi momento (non è richiesta alcuna autenticazione):
curl -sS https://tronbid.com/api/public/quick-rent/skusPaga TRX da qualsiasi wallet. L’Energy o il Bandwidth verrà inviato al destinatario indicato nell’ordine. Non è necessario selezionare un wallet di pagamento. POST /quote → POST /orders (target_address, payment_mode: "onchain") → amount_trx TRX → pay_address → GET /orders/:id. Invia l’importo esatto all’indirizzo di pagamento di questo ordine prima della scadenza. Non riutilizzare l’indirizzo di pagamento di un ordine precedente.
Alias precedente facoltativo di target_address; non limita il wallet utilizzato per pagare.
Invia l’importo esatto all’indirizzo di pagamento di questo ordine prima della scadenza. Non riutilizzare l’indirizzo di pagamento di un ordine precedente.
{
"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..."
}Passaggio 1: OTTIENI /balance per controllare il tuo TRX. Passaggio 2: POST/preventivo per il prezzo. Passaggio 3: POST/ordini con modalità_pagamento: saldo da addebitare e avvio della delega. Passaggio 4: poll GET /orders/:id fino alla delega (in caso di errore di delega la delega diventa fallita e TRX viene rimborsato sul tuo saldo).
payer_address non è necessario: paga l'account collegato alla tua chiave API. L'energy_amount nella risposta può essere superiore allo SKU ordinato (bonus matrice prezzo).
{
"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..."
}Ogni ordine passa attraverso questi stati. Sondaggio GET /orders/:id per seguirlo.
| Status | Significato |
|---|---|
pending_payment | In attesa del pagamento in catena |
delegating | Pagamento ricevuto o saldo addebitato; delegazione in corso |
delegated | Energia delegata |
cancelled | Annullato prima del pagamento (on-chain) |
expired | La finestra di pagamento in catena è scaduta |
failed | Errore (per il saldo, TRX viene rimborsato) |
idempotency_key (8–128 caratteri) è un ID ordine univoco dalla tua parte. La ripetizione di POST /orders con la stessa chiave (per lo stesso client API) restituisce lo stesso ordine con "duplicato": true.
Non riutilizzare una idempotency_key in diverse modalità di pagamento (onchain o saldo): restituisce 409 IDEMPOTENCY_PAYMENT_MODE_MISMATCH.
Stimare la quantità di energia necessaria a un indirizzo per un trasferimento. Passa il portafoglio del destinatario e indica se contiene già USDT.
/api/v2/quick-rent/calculator| Parametro | Type | Descrizione | Example |
|---|---|---|---|
indirizzo_portafoglio | string | Indirizzo TRON da analizzare | TXXXXXXXX...XXXX |
has_usdt | boolean | null | Se il destinatario detiene già USDT (influisce sull'energia). vero, falso o omettere. | 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}'Restituisce il prezzo corrente per un pacchetto: price_trx, disponibilità, save_percent e per quanto tempo è valido il preventivo (expires_in_sec).
/api/v2/quick-rent/quote| Parametro | Type | Descrizione | Example |
|---|---|---|---|
energia_quantità | int | Quantità di energia dal catalogo attivo | 131000 |
durata_minuti | int | Durata noleggio da catalogo | 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}'Paga TRX da qualsiasi wallet. L’Energy o il Bandwidth verrà inviato al destinatario indicato nell’ordine. Non è necessario selezionare un wallet di pagamento. POST /orders (target_address, payment_mode: "onchain") → pay_address, amount_trx, expires_at.
Invia l’importo esatto all’indirizzo di pagamento di questo ordine prima della scadenza. Non riutilizzare l’indirizzo di pagamento di un ordine precedente.
/api/v2/quick-rent/orders| Parametro | Type | Descrizione | Example |
|---|---|---|---|
energy_amount | int | Quantità di energia dal catalogo | 131000 |
duration_minutes | int | Durata noleggio da catalogo | 15 |
idempotency_key | string | Il tuo ID ordine univoco (8-128 caratteri) | partner-onchain-001 |
payment_mode | string | Facoltativo. "onchain" (predefinito) o "balance". | balance |
payer_address | string | Alias precedente facoltativo di target_address; non limita il wallet utilizzato per pagare. | TTarget... |
target_address | string | Destinatario della risorsa. Paga TRX da qualsiasi wallet. L’Energy o il Bandwidth verrà inviato al destinatario indicato nell’ordine. Non è necessario selezionare un wallet di pagamento. | 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..."
}'Restituisce lo stato corrente, la modalità_pagamento, gli importi, gli indirizzi e il codice_errore/messaggio_errore se qualcosa non è riuscito. Effective_energy_amount riflette l'effettiva energia delegata dopo il pagamento insufficiente/eccessivo.
/api/v2/quick-rent/orders/:id| Parametro | Type | Descrizione | Example |
|---|---|---|---|
id | string | ID ordine (parametro percorso) | 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"Annulla un ordine ancora in sospeso_pagamento (solo on-chain). Una volta delegata l'energia, l'ordine non potrà più essere annullato.
/api/v2/quick-rent/orders/:id/cancel| Parametro | Type | Descrizione | Example |
|---|---|---|---|
id | string | ID ordine (parametro percorso) | uuid |
curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID/cancel" \
-H "Authorization: Bearer $API_KEY"Restituisce il saldo TRX dell'account TronBid collegato alla tua chiave API (il tuo saldo in-app, non un portafoglio on-chain). Richiede l'intestazione di autorizzazione.
/api/v2/quick-rent/balance{ "balance_trx": "150.500000" }curl -sS "$BASE_URL/api/v2/quick-rent/balance" \
-H "Authorization: Bearer $API_KEY"Gli errori restituiscono uno stato HTTP e un campo di errore. Ecco quelli che potresti incontrare.
| HTTP | error | Quando |
|---|---|---|
| 400 | Invalid body | JSON o campi non validi |
| 400 | INVALID_SKU / SKU_INACTIVE | Pacchetto non disponibile |
| 400 | INVALID_PAYER_ADDRESS / INVALID_TARGET_ADDRESS | Indirizzo TRON non valido |
| 400 | INSUFFICIENT_BALANCE | TRX insufficiente in equilibrio (modalità equilibrio) |
| 401 | Unauthorized | Chiave API mancante o non valida |
| 403 | BALANCE_PAYMENT_NOT_ENABLED | Pagamento del saldo non abilitato per la tua chiave |
| 409 | PENDING_PAYMENT_INTENT_EXISTS | Destinatario della risorsa: pending_payment |
| 409 | ACTIVE_DELEGATION_EXISTS | Target ha già una delegazione Quick Rent attiva |
| 409 | POOL_ENERGY_INSUFFICIENT | Nessuna energia gratuita per la piscina in questo momento |
| 409 | IDEMPOTENCY_PAYMENT_MODE_MISMATCH | Stessa idempotency_key con una modalità di pagamento diversa |
| 429 | Too Many Requests | Limite di tariffa |
| 503 | — | Servizio momentaneamente non disponibile, riprova più tardi |
Situazioni comuni e cosa fare, in parole povere.
Invia l’importo esatto all’indirizzo di pagamento di questo ordine prima della scadenza. Non riutilizzare l’indirizzo di pagamento di un ordine precedente. Paga TRX da qualsiasi wallet. L’Energy o il Bandwidth verrà inviato al destinatario indicato nell’ordine. Non è necessario selezionare un wallet di pagamento. GET /orders/:id → status
La delega non ha avuto successo. Per i pagamenti a saldo, il TRX viene automaticamente restituito al tuo saldo. Il motivo è in error_code e error_message di GET /orders/:id. Puoi creare un nuovo ordine.
Destinatario della risorsa: pending_payment. GET /orders/:id; POST /orders/:id/cancel; expires_at.
Il pagamento del saldo non è abilitato per la tua chiave. Contatta il supporto TronBid per attivarlo o utilizza on-chain (impostazione predefinita).
Troppe richieste in poco tempo. Ridurre la frequenza di polling (ad esempio una volta ogni 3 secondi) e riprovare più tardi.
In caso di pagamento insufficiente/eccessivo in catena, l'importo finale cambia. Controlla Effective_energy_amount in GET /orders/:id — questa è l'energia effettivamente delegata.
Hai bisogno dell'accesso API, di limiti più elevati o del pagamento del saldo abilitato? Contattaci e ti aiuteremo.