REST-API v2Documentatie bijgewerkt op 2 augustus 2026

TRON Energy Rental API — Automatiseer USDT TRC-20-overboekingen

Integreer API v2 om TRON Energy-huurorders programmatisch te citeren, aan te maken en te volgen. Betaal on-chain of vanuit uw TronBid-saldo en verminder de TRX die wordt verbrand door smart-contract-oproepen.

Live offertes en pakketcatalogus
Betaling via keten of saldo
Idempotente bestellingen en statusonderzoek

Krijg API-toegang Open Snelstart Energie huren zonder API Bereken de energiebehoefte

Op deze pagina

TRON Energy Rental API: overzicht en gebruiksscenario's

De Quick Rent API is een manier om TRON Energy automatisch te huren, zonder handmatig werk. Energie maakt USDT (TRC-20)-overboekingen en andere smart-contract-oproepen goedkoper dan het verbranden van TRX.

In duidelijke woorden: uw programma (een site, bot of dienst) koopt zelf energie, precies wanneer dat nodig is, bijvoorbeeld vóór elke USDT-overboeking die uw klant doet.

Denk aan een automaat: je controleert de prijs, gooit geld in de automaat en haalt je artikel op. De API bestaat uit dezelfde reeks knoppen: alleen uw programma drukt erop.

1
Vraag een prijs aan
Je programma vraagt aan de API hoeveel het benodigde energiepakket op dit moment kost.
2
Maak een bestelling aan en betaal
Uw programma maakt een bestelling aan en betaalt deze - door TRX naar het opgegeven adres te sturen of door uw TronBid-saldo in rekening te brengen.
3
Krijg de energie
Binnen een paar seconden verschijnt er energie op de doelportemonnee en kan USDT goedkoper worden verzonden.

Belangrijk: de API is een hulpmiddel voor een ontwikkelaar. Om het te gebruiken, moet iemand code schrijven die de verzoeken verzendt.

Als er niemand is om code te schrijven, gebruik dan de kant-en-klare energieaankoop op de site (Quick Rent) of de Telegram-bot @tronbid. Hetzelfde resultaat, alleen handmatig gedaan.

Quickstart: van nul naar energie

Een volledig end-to-end voorbeeld van het eenvoudigste scenario (on-chain). Vier stappen en energie is op de portemonnee.

Hieronder ziet u wat er bij elke stap gebeurt en wat de API retourneert. Sluit uw API-sleutel, adressen en bestel-ID aan.

1
Stap 1. Ontvang een prijs - POST /offerte
Stuur de hoeveelheid energie en de duur ervan. Je krijgt price_trx terug en hoeveel seconden het is vergrendeld.
2
Stap 2. Maak een bestelling aan — POST /orders
Verzend het pakket, uw idempotency_key en betaler_adres. U krijgt pay_address (waar u moet betalen), bedrag_trx (hoeveel) en vervalt_at (tot wanneer).
3
Stap 3. Betalen
Stuur exact bedrag_trx TRX naar betaaladres vanaf uw betaleradres. Het is een gewone TRON-overdracht.
4
Stap 4. Wacht op energie — GET /orders/:id
Controleer de status elke paar seconden totdat deze wordt gedelegeerd. Dat betekent dat energie naar de portemonnee wordt gedelegeerd – klaar.

Reactie

json

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

Reactie (op de keten)

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

krul

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

Reactie

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
}

Woordenlijst

Korte uitleg van de woorden die in deze documentatie worden gebruikt.

Energie: De ‘brandstof’ van het TRON-netwerk voor slimme contractoperaties. Als er niet genoeg is, verbrandt het netwerk in plaats daarvan TRX, wat duurder is. Energie huren bespaart geld.
TRX: De inheemse munt van het TRON-netwerk. Het betaalt de energiehuur en netwerkkosten.
USDT TRC-20: Een stablecoin (dollar) op TRON. Het verzenden ervan is een smart-contract-oproep die energie nodig heeft.
API-sleutel: Uw geheime wachtwoord voor API-toegang. Wordt bij elk verzoek verzonden. Bewaar het alleen op de server.
Eindpunt: Een specifiek adres-"knop" van de API waar uw programma een verzoek naartoe stuurt (bijvoorbeeld /quote - ontvang een prijs).
KRIJGEN/POST: Verzoektypen. GET betekent "gewoon gegevens vragen / lezen"; POST betekent "een actie ondernemen" (een bestelling plaatsen, een prijs berekenen).
Token aan toonder: Hoe u de API-sleutel doorgeeft: de header luidt Autorisatie: Bearer YOUR_KEY.
Betaling aan de ketting: Een bestelling betalen met een gewone TRX-overboeking naar het opgegeven adres — werkt meteen, er is niets in te schakelen.
Saldobetaling: Betalen door het saldo van uw TronBid-account in rekening te brengen. Sneller, maar moet eerst worden ingeschakeld voor uw sleutel.
delegatie: Het tijdelijk overhandigen van de gehuurde energie aan de doelportemonnee voor de huurperiode (bijvoorbeeld 15 of 60 minuten).
Polling: Het periodiek opnieuw opvragen van de orderstatus (elke paar seconden) totdat deze wordt gedelegeerd of eindigt met een fout.
idempotentie_sleutel: Uw unieke bestel-ID. Als een verzoek twee keer wordt verzonden, retourneert de API dezelfde bestelling in plaats van een nieuwe aan te maken – bescherming tegen dubbele betaling.

Voordat je begint

Wat u moet voorbereiden voordat u uw eerste verzoek indient.

1
Vraag een API-sleutel aan
Stuur een bericht naar @tronbid op Telegram — u ontvangt een sleutel die is gekoppeld aan uw TronBid-account. Zonder dit kunnen verzoeken niet worden aangenomen.
2
Zorg voor een doel-TRON-portemonnee
Bepaal het adres (doel_adres) dat energie nodig heeft. Meestal is dit de portemonnee waaruit uw klanten USDT verzenden.
3
Kies een pakket uit de catalogus
Energie wordt verkocht in pakketten (meestal 65000 of 131000 energie voor 15 of 60 minuten). Haal de livelijst op van het cataloguseindpunt, geen verificatie vereist.
4
Betaling voorbereiden
Voor on-chain: een portemonnee met TRX om te betalen. Voor saldobetaling: een gefinancierde TronBid-rekening en de saldomodus ingeschakeld.

Basis-URL van de productie-API

Met de Quick Rent API kan uw service TRON Energy automatisch huren, zodat USDT TRC-20-overboekingen en andere smart-contract-oproepen minder kosten dan het verbranden van TRX.

Alle eindpunten delen één basis-URL.

Basis-URL (productie)

http

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

Autorisatie

Bij elk verzoek moet uw API-sleutel als Bearer-token in de Authorization-header worden opgenomen.

Bewaar de sleutel alleen aan de serverzijde (backend, CI-geheimen). Verzend het nooit in frontend-code of openbare opslagplaatsen. De sleutel is gebonden aan één TronBid-account (de portemonnee die is ingesteld toen toegang werd verleend); saldobetalingen kunnen alleen van die rekening worden gehaald.

Als u de snelheidslimiet overschrijdt, reageert de API met HTTP 429.

http

Authorization: Bearer <API_KEY>

Betalingswijzen

Er zijn twee manieren om een bestelling te betalen. On-chain is de standaard en vereist geen configuratie. Saldobetaling is optioneel en moet zijn ingeschakeld voor uw sleutel.

Zonder activering retourneert een verzoek met payment_mode: balance 403 BALANCE_PAYMENT_NOT_ENABLED. Neem contact op met de ondersteuning van TronBid om dit in te schakelen.

Mode	Hoe in te schakelen	Betaling
`on-chain`	Standaard – laat payment_mode (of "onchain") weg	Stuur TRX naar betaaladres vanaf betaleradres
`balance`	payment_mode: saldo + ingeschakeld voor uw sleutel	Afgeschreven van uw TronBid TRX-saldo

Pakketcatalogus

energie_bedrag en duur_minuten moeten overeenkomen met een actief Quick Rent-pakket – meestal 65000 of 131000 energie en 15 of 60 minuten.

Haal op elk gewenst moment de huidige catalogus op (geen verificatie vereist):

De actieve catalogus ophalen (geen authenticatie)

bash

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

Stroom in de keten

Stap 1 — POST/quote om de prijs te weten te komen. Stap 2 — POST/orders om de bestelling aan te maken en betaaladres, bedrag_trx en vervalt_at te ontvangen. Stap 3 — stuur exact bedrag_trx TRX naar betaaladres vanaf uw betaleradres. Stap 4 — poll GET /orders/:id totdat de status is gedelegeerd (of mislukt / verlopen / geannuleerd).

doeladres is optioneel: als dit wordt weggelaten, wordt energie gedelegeerd aan betaleradres.

Er is slechts één open on-chain order (pending_payer) tegelijk toegestaan per betaleradres; anders krijg je 409 PENDING_PAYMENT_INTENT_EXISTS. Bij onder-/overbetaling kan de uiteindelijke energie verschillen. Controleer de effectieve_energiehoeveelheid in GET /orders/:id.

Lichaam aanvragen

json

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

Reactie

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

Evenwichtsstroom

Stap 1 — GET /balance om uw TRX te controleren. Stap 2 — POST/offerte voor de prijs. Stap 3 — POST/bestellingen met payment_mode: saldo naar debet en start delegatie. Stap 4 — peil GET /orders/:id totdat het wordt gedelegeerd (bij een delegatiefout wordt het mislukt en wordt TRX terugbetaald op uw saldo).

betaler_adres is niet nodig; het account dat aan uw API-sleutel is gekoppeld, betaalt. De energie_hoeveelheid in het antwoord kan hoger zijn dan de bestelde SKU (prijsmatrixbonus).

Lichaam aanvragen

json

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

Reactie

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

Bestelstatussen

Elke bestelling doorloopt deze statussen. Poll GET /orders/:id om het te volgen.

Status	Betekenis
`pending_payment`	Wachten op betaling via de keten
`delegating`	Betaling ontvangen of saldo in rekening gebracht; delegatie bezig
`delegated`	Energie gedelegeerd
`cancelled`	Geannuleerd vóór betaling (on-chain)
`expired`	Betalingstermijn aan de keten is verstreken
`failed`	Fout (voor saldo wordt TRX terugbetaald)

Idempotentie

idempotency_key (8–128 tekens) is een unieke order-ID aan uw kant. Het herhalen van POST/bestellingen met dezelfde sleutel (voor dezelfde API-client) retourneert dezelfde bestelling met "duplicate": true.

Gebruik één idempotency_key niet opnieuw voor verschillende betalingsmodi (onchain versus saldo) - dat retourneert 409 IDEMPOTENCY_PAYMENT_MODE_MISMATCH.

Bereken de huurvereisten van TRON Energy

Schat in hoeveel energie een adres nodig heeft voor een overdracht. Geef de portemonnee van de ontvanger door en of deze al USDT bevat.

POST/api/v2/quick-rent/calculator

Parameters

Parameter	Type	Beschrijving	Example
`portemonnee_adres`	string	TRON-adres om te analyseren	`TXXXXXXXX...XXXX`
`heeft_usdt`	boolean \| null	Of de ontvanger al USDT in zijn bezit heeft (beïnvloedt de energie). waar, onwaar of weggelaten.	`true`

Lichaam aanvragen

json

{
  "wallet_address": "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "has_usdt": true
}

krul

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

Ontvang een huurofferte van TRON Energy

Retourneert de huidige prijs voor een pakket: price_trx, beschikbaarheid, save_percent en hoe lang de offerte geldig is (expires_in_sec).

POST/api/v2/quick-rent/quote

Parameters

Parameter	Type	Beschrijving	Example
`energie_hoeveelheid`	int	Energiehoeveelheid uit de actieve catalogus	`131000`
`duur_minuten`	int	Huurduur uit de catalogus	`15`

Reactie

json

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

krul

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

Maak een TRON Energy-huurorder aan

Creëert een huurorder. Voor on-chain geeft u payer_address door en betaalt u het geretourneerde bedrag_trx aan pay_address. Voor het saldo voegt u payment_mode: balance toe en het gekoppelde account wordt onmiddellijk in rekening gebracht.

doeladres is optioneel (standaard is het betaleradres). Houd u aan de 409-regels: één open on-chain order per betaler en er is geen actieve Quick Rent-delegatie al op het doel gericht (ACTIVE_DELEGATION_EXISTS).

POST/api/v2/quick-rent/orders

Parameters

Parameter	Type	Beschrijving	Example
`energie_hoeveelheid`	int	Energiehoeveelheid uit de catalogus	`131000`
`duur_minuten`	int	Huurduur uit de catalogus	`15`
`idempotentie_sleutel`	string	Uw unieke bestel-ID (8-128 tekens)	`partner-onchain-001`
`betalingsmodus`	string	Optioneel. "onchain" (standaard) of "balance".	`balance`
`betaler_adres`	string	On-chain: portemonnee die TRX verzendt. Niet nodig voor evenwicht.	`TPayer...`
`doel_adres`	string	Optioneel. Portemonnee die energie ontvangt (standaard ingesteld op betaleradres).	`TTarget...`

Reactie (op de keten)

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

Reactie (saldo)

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 (op keten)

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

krul (saldo)

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

Ontvang de bestelstatus

Retourneert de huidige status, betalingsmodus, bedragen, adressen en foutcode / foutbericht als er iets is mislukt. effectieve_energie_hoeveelheid weerspiegelt de daadwerkelijk gedelegeerde energie na onder-/overbetaling.

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

Parameters

Parameter	Type	Beschrijving	Example
`Identiteitskaart`	string	Order-ID (padparameter)	`uuid`

Reactie

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
}

krul

bash

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

Bestelling annuleren

Annuleert een bestelling die nog in behandeling is (alleen on-chain). Zodra energie is gedelegeerd, kan de bestelling niet meer worden geannuleerd.

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

Parameters

Parameter	Type	Beschrijving	Example
`Identiteitskaart`	string	Order-ID (padparameter)	`uuid`

krul

bash

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

Betaler wijzigen

Wijzigt de betalende portemonnee voor een lopende_betaling on-chain bestelling - handig als de klant besluit vanuit een andere portemonnee te betalen voordat TRX wordt verzonden.

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

Parameters

Parameter	Type	Beschrijving	Example
`Identiteitskaart`	string	Order-ID (padparameter)	`uuid`
`betaler_adres`	string	Nieuwe betalende portemonnee	`TNewPayer...`

krul

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

Controleer het TronBid API-saldo

Retourneert het TRX-saldo van het TronBid-account dat is gekoppeld aan uw API-sleutel (uw in-app-saldo, niet een portemonnee in de keten). Vereist de header Autorisatie.

GET/api/v2/quick-rent/balance

Reactie

json

{ "balance_trx": "150.500000" }

krul

bash

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

Foutcodes

Fouten retourneren een HTTP-status en een foutveld. Dit zijn degenen die je kunt tegenkomen.

HTTP	error	Wanneer
400	`Invalid body`	Ongeldige JSON of velden
400	`INVALID_SKU / SKU_INACTIVE`	Pakket niet beschikbaar
400	`INVALID_PAYER_ADDRESS / INVALID_TARGET_ADDRESS`	Verkeerd opgemaakt TRON-adres
400	`INSUFFICIENT_BALANCE`	Niet genoeg TRX per saldo (balansmodus)
401	`Unauthorized`	Ontbrekende of ongeldige API-sleutel
403	`BALANCE_PAYMENT_NOT_ENABLED`	Saldobetaling is niet ingeschakeld voor uw sleutel
409	`PENDING_PAYMENT_INTENT_EXISTS`	Er bestaat al een open on-chain order voor deze betaler
409	`ACTIVE_DELEGATION_EXISTS`	Target heeft al een actieve Quick Rent-delegatie
409	`POOL_ENERGY_INSUFFICIENT`	Er is momenteel geen gratis zwembadenergie
409	`IDEMPOTENCY_PAYMENT_MODE_MISMATCH`	Dezelfde idempotency_key met een andere betalingsmodus
429	`Too Many Requests`	Tarieflimiet
503	`—`	Service tijdelijk niet beschikbaar. Probeer het later opnieuw

Als er iets misgaat

Veelvoorkomende situaties en wat u moet doen, in duidelijke bewoordingen.

Ik heb betaald, maar de bestelling blijft hangen in afwachting van betaling

Zorg ervoor dat het overgemaakte bedrag exact gelijk is aan amount_trx en dat het geld vanaf het exacte betaleradres naar pay_address is gegaan. De overboeking moet vóórexpirs_at aankomen. De status wordt meestal binnen een minuut na netwerkbevestiging bijgewerkt - blijf GET /orders/:id peilen.

De status is mislukt - wat is het?

Delegatie is niet gelukt. Bij saldobetalingen wordt de TRX automatisch teruggezet naar uw saldo. De reden ligt in de error_code en error_message van GET /orders/:id. U kunt een nieuwe bestelling aanmaken.

Fout 409 PENDING_PAYMENT_INTENT_EXISTS

Dit betaleradres heeft al een onbetaalde bestelling in de keten. Betaal het, wacht tot het verloopt (expires_at), of annuleer het via /orders/:id/cancel, en maak dan een nieuw aan.

Fout 403 BALANCE_PAYMENT_NOT_ENABLED

Saldobetaling is niet ingeschakeld voor uw sleutel. Neem contact op met de ondersteuning van TronBid om het te activeren, of gebruik on-chain (de standaard).

Fout 429 Te veel verzoeken

Teveel aanvragen in korte tijd. Verlaag de pollingfrequentie (bijvoorbeeld elke 3 seconden) en probeer het later opnieuw.

Ik kreeg minder energie dan ik had besteld

Bij onderbetaling/overbetaling in de keten verandert het uiteindelijke bedrag. Controleer de effectieve_energiehoeveelheid in GET /orders/:id — dat is de daadwerkelijk gedelegeerde energie.

Ondersteuning voor TRON Energy API-integratie

Heeft u API-toegang, hogere limieten of saldobetaling nodig? Neem contact op en wij helpen u.

API-toegang en saldobetalingTelegram @tronbid

E-mailsupport@tronbid.com