REST API v2Dokumentationen uppdaterad 2 augusti 2026

TRON Energy Rental API — Automatisera USDT TRC-20-överföringar

Integrera API v2 för att citera, skapa och spåra TRON Energy-uthyrningsbeställningar programmatiskt. Betala på kedjan eller från ditt TronBid-saldo och minska den TRX som förbränns av samtal med smarta kontrakt.

Live offerter och paketkatalog
On-chain eller balansbetalning
Idempotenta order och statusundersökning

Få API-åtkomst Öppna Snabbstart Hyr energi utan API Beräkna energibehov

På den här sidan

TRON Energy Rental API: översikt och användningsfall

Quick Rent API är ett sätt att hyra TRON Energy automatiskt, utan manuellt arbete. Energi gör USDT (TRC-20)-överföringar och andra smarta kontraktssamtal billigare än att bränna TRX.

Med enkla ord: ditt program (en webbplats, bot eller tjänst) köper energi själv, precis när det behövs – till exempel innan varje USDT-överföring som din kund gör.

Tänk på en varuautomat: du kontrollerar priset, sätter in pengar, får din vara. API:et är samma uppsättning knappar - bara ditt program trycker på dem.

1
Fråga efter pris
Ditt program frågar API:et hur mycket energipaketet som behövs kostar just nu.
2
Skapa en beställning och betala
Ditt program skapar en beställning och betalar den — genom att skicka TRX till den angivna adressen eller genom att debitera ditt TronBid-saldo.
3
Få energin
Inom några sekunder dyker energi upp på målplånboken, och USDT kan skickas billigare.

Viktigt: API:et är ett verktyg för en utvecklare. För att använda den måste någon skriva kod som skickar förfrågningarna.

Om det inte finns någon att skriva kod — använd det färdiga energiköpet på sajten (Quick Rent) eller Telegram-boten @tronbid. Samma resultat, bara gjort manuellt.

Snabbstart: från noll till energi

Ett fullständigt exempel på det enklaste scenariot (på kedjan). Fyra steg och energi ligger på plånboken.

Nedan är vad som händer i varje steg och vad API:et returnerar. Anslut din API-nyckel, adresser och beställnings-id.

1
Steg 1. Få ett pris — POST /offert
Skicka energimängd och varaktighet. Du får tillbaka price_trx och hur många sekunder den är låst i.
2
Steg 2. Skapa en beställning — POST /order
Skicka paketet, din idempotency_key och payer_address. Du får pay_address (var du ska betala), summa_trx (hur mycket) och expires_at (tills när).
3
Steg 3. Betala
Skicka exakt amount_trx TRX till pay_address från din payer_address. Det är en vanlig TRON-överföring.
4
Steg 4. Vänta på energi — GET /orders/:id
Fråga status varannan sekund tills den blir delegerad. Det betyder att energi delegeras till plånboken - klart.

Svar

json

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

Svar (på kedjan)

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

Svar

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
}

Ordlista

Korta förklaringar av orden som används i denna dokumentation.

Energi: TRON-nätverkets "bränsle" för smarta kontraktsoperationer. Om det inte räcker, bränner nätverket TRX istället — vilket är dyrare. Att hyra energi sparar pengar.
TRX: Det ursprungliga myntet i TRON-nätverket. Den betalar energihyra och nätavgifter.
USDT TRC-20: Ett stablecoin (dollar) på TRON. Att skicka det är ett smart kontraktsamtal som kräver energi.
API-nyckel: Ditt hemliga lösenord för API-åtkomst. Skickas med varje förfrågan. Behåll den bara på servern.
Slutpunkt: En specifik adress-"knapp" för API:t där ditt program skickar en förfrågan (t.ex. /quote — få ett pris).
HÄMTA/POSTA: Begäran typer. GET betyder "bara fråga/läs data"; POST betyder "gör en åtgärd" (skapa en beställning, beräkna ett pris).
Bärartoken: Hur du skickar API-nyckeln: rubriken läser Authorization: Bearer YOUR_KEY.
Kedjebetalning: Att betala en beställning med en vanlig TRX-överföring till den angivna adressen — fungerar direkt, inget att aktivera.
Balansbetalning: Betala genom att debitera ditt TronBid-kontosaldo. Snabbare, men måste aktiveras för din nyckel först.
Delegation: Tillfälligt överlämna den hyrda energin till målplånboken för hyresperioden (t.ex. 15 eller 60 minuter).
Omröstning: Fråga om orderstatus regelbundet (med några sekunders mellanrum) tills den delegeras eller slutar med ett fel.
idempotensnyckel: Ditt unika order-id. Om en begäran skickas två gånger returnerar API:et samma beställning istället för att skapa en ny – skydd mot dubbelbetalning.

Innan du börjar

Vad du ska förbereda innan du gör din första förfrågan.

1
Skaffa en API-nyckel
Meddelande @tronbid på Telegram — du får en nyckel bunden till ditt TronBid-konto. Förfrågningar går inte igenom utan det.
2
Ha en mål TRON-plånbok
Bestäm adressen (target_address) som behöver energi. Vanligtvis är det plånboken dina kunder skickar USDT från.
3
Välj ett paket från katalogen
Energi säljs i förpackningar (vanligtvis 65000 eller 131000 energi för 15 eller 60 minuter). Hämta livelistan från katalogens slutpunkt, ingen autentisering behövs.
4
Förbered betalning
För on-chain — en plånbok med TRX att betala. För balansbetalning — ett finansierat TronBid-konto och balansläget aktiverat.

Produktions-API-bas-URL

Quick Rent API låter din tjänst hyra TRON Energy automatiskt, så USDT TRC-20-överföringar och andra smarta kontraktssamtal kostar mindre än att bränna TRX.

Alla slutpunkter delar en bas-URL.

Bas-URL (produktion)

http

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

Auktorisation

Varje begäran måste inkludera din API-nyckel som en bärartoken i auktoriseringshuvudet.

Behåll nyckeln endast på serversidan (backend, CI-hemligheter). Skicka den aldrig i frontend-kod eller offentliga förråd. Nyckeln är bunden till ett enda TronBid-konto (plånboken som sattes in när åtkomst beviljades); balansbetalningar kan endast dras från det kontot.

Om du överskrider hastighetsgränsen svarar API:et med HTTP 429.

http

Authorization: Bearer <API_KEY>

Betalningssätt

Det finns två sätt att betala för en beställning. On-chain är standard och behöver ingen installation. Balansbetalning är valfri och måste vara aktiverad för din nyckel.

Utan aktivering returnerar en begäran med betalningsläge: saldo 403 BALANCE_PAYMENT_NOT_ENABLED. För att aktivera det, kontakta TronBid support.

Mode	Hur man aktiverar	Betalning
`on-chain`	Standard — utelämna betalningsläge (eller "onchain")	Skicka TRX till pay_address från payer_address
`balance`	betalningsläge: balans + aktiverat för din nyckel	Debiteras från ditt TronBid TRX-saldo

Paketkatalog

energy_amount och duration_minutes måste matcha ett aktivt Quick Rent-paket — vanligtvis 65 000 eller 131 000 energi och 15 eller 60 minuter.

Hämta den aktuella katalogen när som helst (ingen autentisering krävs):

Hämta den aktiva katalogen (ingen autentisering)

bash

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

On-chain Flow

Steg 1 — POST / offert för att lära dig priset. Steg 2 — POST /ordrar för att skapa beställningen och ta emot pay_address, amount_trx och expires_at. Steg 3 — skicka exakt amount_trx TRX till pay_address från din payer_address. Steg 4 — undersökning GET /orders/:id tills statusen delegeras (eller misslyckades / har gått ut / avbruten).

target_address är valfritt – om den utelämnas delegeras energi till payer_address.

Endast en öppen beställning i kedjan (pending_payment) är tillåten per payer_address åt gången; annars får du 409 PENDING_PAYMENT_INTENT_EXISTS. Vid under-/överbetalning kan den slutliga energin skilja sig — kontrollera effektiv_energimängd i GET /orders/:id.

Begäran kropp

json

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

Svar

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

Balansflöde

Steg 1 — HÄMTA /balans för att kontrollera din TRX. Steg 2 — POST / offert för priset. Steg 3 — POST/ordrar med betalningsläge: saldo att debitera och starta delegering. Steg 4 — poll GET /orders/:id tills det delegerats (vid ett delegeringsfel misslyckas det och TRX återbetalas till ditt saldo).

payer_address behövs inte – kontot som är länkat till din API-nyckel betalar. Energibeloppet i svaret kan vara högre än den beställda SKU (prismatrisbonus).

Begäran kropp

json

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

Svar

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

Orderstatus

Varje beställning rör sig genom dessa statusar. Poll GET /orders/:id för att följa det.

Status	Mening
`pending_payment`	Väntar på betalning i kedjan
`delegating`	Mottagen betalning eller saldo debiteras; delegation pågår
`delegated`	Energi delegerad
`cancelled`	Avbröt före betalning (på kedjan)
`expired`	Betalningsperioden i kedjan har förflutit
`failed`	Fel (för saldo, TRX återbetalas)

Idempotens

idempotency_key (8–128 tecken) är ett unikt order-ID på din sida. Upprepad POST /order med samma nyckel (för samma API-klient) returnerar samma order med "duplicering": true.

Återanvänd inte en idempotency_key över olika betalningssätt (onchain kontra saldo) – det returnerar 409 IDEMPOTENCY_PAYMENT_MODE_MISMATCH.

Beräkna TRON Energy hyreskrav

Uppskatta hur mycket energi en adress behöver för en överföring. Skicka mottagarplånboken och om den redan har USDT.

POST/api/v2/quick-rent/calculator

Parametrar

Parameter	Type	Beskrivning	Example
`wallet_address`	string	TRON-adress att analysera	`TXXXXXXXX...XXXX`
`has_usdt`	boolean \| null	Om mottagaren redan innehar USDT (påverkar energi). sant, falskt eller utelämna.	`true`

Begäran kropp

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

Få en offert för hyr av TRON Energy

Returnerar det aktuella priset för ett paket: price_trx, tillgänglighet, save_percent och hur länge offerten är giltig (expires_in_sec).

POST/api/v2/quick-rent/quote

Parametrar

Parameter	Type	Beskrivning	Example
`energimängd`	int	Energimängd från den aktiva katalogen	`131000`
`duration_minutes`	int	Uthyrningstid från katalogen	`15`

Svar

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

Skapa en hyresorder för TRON Energy

Skapar en hyresorder. För on-chain, skicka payer_address och betala det returnerade beloppet_trx till pay_address. För saldo, lägg till betalningsläge: saldo och det länkade kontot debiteras omedelbart.

target_address är valfritt (standard till payer_address). Tänk på de 409 reglerna: en öppen beställning i kedjan per betalare och ingen aktiv delegering av snabbhyra som redan är på målet (ACTIVE_DELEGATION_EXISTS).

POST/api/v2/quick-rent/orders

Parametrar

Parameter	Type	Beskrivning	Example
`energimängd`	int	Energimängd från katalogen	`131000`
`duration_minutes`	int	Uthyrningstid från katalogen	`15`
`idempotensnyckel`	string	Ditt unika order-id (8–128 tecken)	`partner-onchain-001`
`betalningsläge`	string	Valfritt. "onchain" (standard) eller "balans".	`balance`
`betalaradress`	string	On-chain: plånbok som skickar TRX. Behövs inte för balans.	`TPayer...`
`måladress`	string	Valfritt. Plånbok som tar emot energi (standard till payer_address).	`TTarget...`

Svar (på kedjan)

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

Svar (balans)

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 (på kedjan)

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

Få orderstatus

Returnerar aktuell status, betalningsläge, belopp, adresser och felkod/felmeddelande om något misslyckades. effektiv_energibelopp återspeglar den faktiska delegerade energin efter under-/överbetalning.

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

Parametrar

Parameter	Type	Beskrivning	Example
`id`	string	Order-id (sökvägsparameter)	`uuid`

Svar

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"

Avbryt beställning

Annullerar en beställning som fortfarande väntar_betalning (endast i kedjan). När energi har delegerats kan beställningen inte längre annulleras.

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

Parametrar

Parameter	Type	Beskrivning	Example
`id`	string	Order-id (sökvägsparameter)	`uuid`

curL

bash

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

Byt betalare

Ändrar betalningsplånboken för en pending_payment on-chain-order — användbart om kunden bestämmer sig för att betala från en annan plånbok innan han skickar TRX.

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

Parametrar

Parameter	Type	Beskrivning	Example
`id`	string	Order-id (sökvägsparameter)	`uuid`
`betalaradress`	string	Ny betalande plånbok	`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..."}'

Kontrollera TronBid API-saldo

Returnerar TRX-saldot för TronBid-kontot kopplat till din API-nyckel (ditt saldo i appen, inte en plånbok i kedjan). Kräver auktoriseringshuvudet.

GET/api/v2/quick-rent/balance

Svar

json

{ "balance_trx": "150.500000" }

curL

bash

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

Felkoder

Fel returnerar en HTTP-status och ett felfält. Här är de du kan stöta på.

HTTP	error	När
400	`Invalid body`	Ogiltiga JSON eller fält
400	`INVALID_SKU / SKU_INACTIVE`	Paketet är inte tillgängligt
400	`INVALID_PAYER_ADDRESS / INVALID_TARGET_ADDRESS`	Felaktig TRON-adress
400	`INSUFFICIENT_BALANCE`	Inte tillräckligt med TRX på balans (balansläge)
401	`Unauthorized`	Saknas eller ogiltig API-nyckel
403	`BALANCE_PAYMENT_NOT_ENABLED`	Balansbetalning är inte aktiverad för din nyckel
409	`PENDING_PAYMENT_INTENT_EXISTS`	En öppen beställning i kedjan finns redan för denna betalare
409	`ACTIVE_DELEGATION_EXISTS`	Target har redan en aktiv Quick Rent-delegation
409	`POOL_ENERGY_INSUFFICIENT`	Ingen gratis poolenergi just nu
409	`IDEMPOTENCY_PAYMENT_MODE_MISMATCH`	Samma idempotency_key med ett annat betalningsläge
429	`Too Many Requests`	Prisgräns
503	`—`	Tjänsten är tillfälligt otillgänglig, försök igen senare

Om något går fel

Vanliga situationer och vad man ska göra, i klara ord.

Jag betalade men beställningen har fastnat i pending_payment

Se till att det överförda beloppet är exakt lika med amount_trx och att pengarna gick till pay_address från den exakta payer_address. Överföringen måste anlända före expires_at. Statusen uppdateras vanligtvis inom en minut efter nätverksbekräftelse — fortsätt att polla GET /orders/:id.

Statusen blev misslyckad - vad är det?

Delegationen lyckades inte. För saldobetalningar återförs TRX automatiskt till ditt saldo. Anledningen är felkod och felmeddelande för GET /orders/:id. Du kan skapa en ny beställning.

Fel 409 PENDING_PAYMENT_INTENT_EXISTS

Denna payer_address har redan en obetald on-chain order. Betala den, vänta tills den löper ut (expires_at), eller avbryt den via /orders/:id/cancel, skapa sedan en ny.

Fel 403 BALANCE_PAYMENT_NOT_ENABLED

Balansbetalning är inte aktiverad för din nyckel. Kontakta TronBid support för att aktivera det, eller använd on-chain (standard).

Fel 429 För många förfrågningar

För många förfrågningar på kort tid. Sänk pollingfrekvensen (t.ex. en gång var tredje sekund) och försök igen senare.

Jag fick mindre energi än jag beställde

Med underbetalning/överbetalning i kedjan ändras det slutliga beloppet. Kontrollera effective_energy_amount i GET /orders/:id — det är den energi som faktiskt delegeras.

TRON Energy API integrationsstöd

Behöver API-åtkomst, högre gränser eller balansbetalning aktiverad? Hör av dig så hjälper vi till.

API-åtkomst och saldobetalningTelegram @tronbid

E-postsupport@tronbid.com