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.
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.
Je programma vraagt aan de API hoeveel het benodigde energiepakket op dit moment kost.
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.
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.
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.
Stuur de hoeveelheid energie en de duur ervan. Je krijgt price_trx terug en hoeveel seconden het is vergrendeld.
Ontvanger van de resource: target_address. POST /orders (energy_amount, duration_minutes, idempotency_key, target_address, payment_mode: "onchain") → pay_address, amount_trx, expires_at.
Betaal TRX vanuit elke gewenste wallet. Energy of Bandwidth gaat naar de ontvanger die in de bestelling is opgegeven. Je hoeft geen betaalwallet te selecteren. Stuur vóór het verlopen van deze bestelling het exacte bedrag naar het getoonde betaaladres. Gebruik het betaaladres van een eerdere bestelling niet opnieuw. (amount_trx TRX → pay_address; expires_at)
Controleer de status elke paar seconden totdat deze wordt gedelegeerd. Dat betekent dat energie naar de portemonnee wordt gedelegeerd – klaar.
{
"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
}Korte uitleg van de woorden die in deze documentatie worden gebruikt.
Wat u moet voorbereiden voordat u uw eerste verzoek indient.
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.
Bepaal het adres (doel_adres) dat energie nodig heeft. Meestal is dit de portemonnee waaruit uw klanten USDT verzenden.
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.
Voor on-chain: een portemonnee met TRX om te betalen. Voor saldobetaling: een gefinancierde TronBid-rekening en de saldomodus ingeschakeld.
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.
https://tronbid.com/api/v2/quick-rentEr 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 | Betaal TRX vanuit elke gewenste wallet. Energy of Bandwidth gaat naar de ontvanger die in de bestelling is opgegeven. Je hoeft geen betaalwallet te selecteren. amount_trx TRX → pay_address |
balance | payment_mode: saldo + ingeschakeld voor uw sleutel | Afgeschreven van uw TronBid TRX-saldo |
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):
curl -sS https://tronbid.com/api/public/quick-rent/skusBetaal TRX vanuit elke gewenste wallet. Energy of Bandwidth gaat naar de ontvanger die in de bestelling is opgegeven. Je hoeft geen betaalwallet te selecteren. POST /quote → POST /orders (target_address, payment_mode: "onchain") → amount_trx TRX → pay_address → GET /orders/:id. Stuur vóór het verlopen van deze bestelling het exacte bedrag naar het getoonde betaaladres. Gebruik het betaaladres van een eerdere bestelling niet opnieuw.
Optionele verouderde alias voor target_address; beperkt niet welke wallet voor de betaling wordt gebruikt.
Stuur vóór het verlopen van deze bestelling het exacte bedrag naar het getoonde betaaladres. Gebruik het betaaladres van een eerdere bestelling niet opnieuw.
{
"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..."
}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).
{
"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..."
}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) |
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.
Schat in hoeveel energie een adres nodig heeft voor een overdracht. Geef de portemonnee van de ontvanger door en of deze al USDT bevat.
/api/v2/quick-rent/calculator| 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 |
{
"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}'Retourneert de huidige prijs voor een pakket: price_trx, beschikbaarheid, save_percent en hoe lang de offerte geldig is (expires_in_sec).
/api/v2/quick-rent/quote| Parameter | Type | Beschrijving | Example |
|---|---|---|---|
energie_hoeveelheid | int | Energiehoeveelheid uit de actieve catalogus | 131000 |
duur_minuten | int | Huurduur uit de catalogus | 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}'Betaal TRX vanuit elke gewenste wallet. Energy of Bandwidth gaat naar de ontvanger die in de bestelling is opgegeven. Je hoeft geen betaalwallet te selecteren. POST /orders (target_address, payment_mode: "onchain") → pay_address, amount_trx, expires_at.
Stuur vóór het verlopen van deze bestelling het exacte bedrag naar het getoonde betaaladres. Gebruik het betaaladres van een eerdere bestelling niet opnieuw.
/api/v2/quick-rent/orders| Parameter | Type | Beschrijving | Example |
|---|---|---|---|
energy_amount | int | Energiehoeveelheid uit de catalogus | 131000 |
duration_minutes | int | Huurduur uit de catalogus | 15 |
idempotency_key | string | Uw unieke bestel-ID (8-128 tekens) | partner-onchain-001 |
payment_mode | string | Optioneel. "onchain" (standaard) of "balance". | balance |
payer_address | string | Optionele verouderde alias voor target_address; beperkt niet welke wallet voor de betaling wordt gebruikt. | TTarget... |
target_address | string | Ontvanger van de resource. Betaal TRX vanuit elke gewenste wallet. Energy of Bandwidth gaat naar de ontvanger die in de bestelling is opgegeven. Je hoeft geen betaalwallet te selecteren. | 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..."
}'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.
/api/v2/quick-rent/orders/:id| Parameter | Type | Beschrijving | Example |
|---|---|---|---|
Identiteitskaart | string | Order-ID (padparameter) | 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"Annuleert een bestelling die nog in behandeling is (alleen on-chain). Zodra energie is gedelegeerd, kan de bestelling niet meer worden geannuleerd.
/api/v2/quick-rent/orders/:id/cancel| Parameter | Type | Beschrijving | Example |
|---|---|---|---|
Identiteitskaart | string | Order-ID (padparameter) | uuid |
curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID/cancel" \
-H "Authorization: Bearer $API_KEY"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.
/api/v2/quick-rent/balance{ "balance_trx": "150.500000" }curl -sS "$BASE_URL/api/v2/quick-rent/balance" \
-H "Authorization: Bearer $API_KEY"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 | Ontvanger van de resource: pending_payment |
| 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 |
Veelvoorkomende situaties en wat u moet doen, in duidelijke bewoordingen.
Stuur vóór het verlopen van deze bestelling het exacte bedrag naar het getoonde betaaladres. Gebruik het betaaladres van een eerdere bestelling niet opnieuw. Betaal TRX vanuit elke gewenste wallet. Energy of Bandwidth gaat naar de ontvanger die in de bestelling is opgegeven. Je hoeft geen betaalwallet te selecteren. GET /orders/:id → status
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.
Ontvanger van de resource: pending_payment. GET /orders/:id; POST /orders/:id/cancel; expires_at.
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).
Teveel aanvragen in korte tijd. Verlaag de pollingfrequentie (bijvoorbeeld elke 3 seconden) en probeer het later opnieuw.
Bij onderbetaling/overbetaling in de keten verandert het uiteindelijke bedrag. Controleer de effectieve_energiehoeveelheid in GET /orders/:id — dat is de daadwerkelijk gedelegeerde energie.
Heeft u API-toegang, hogere limieten of saldobetaling nodig? Neem contact op en wij helpen u.