Integrieren Sie API v2, um TRON Energy-Mietaufträge programmgesteuert anzubieten, zu erstellen und zu verfolgen. Bezahlen Sie in der Kette oder von Ihrem TronBid-Guthaben und reduzieren Sie den durch Smart-Contract-Aufrufe verbrannten TRX.
Die Quick Rent API ist eine Möglichkeit, TRON Energy automatisch und ohne manuelle Arbeit zu mieten. Energie macht USDT (TRC-20)-Überweisungen und andere Smart-Contract-Anrufe billiger als das Verbrennen von TRX.
Im Klartext: Ihr Programm (eine Website, ein Bot oder ein Dienst) kauft selbst Energie, genau dann, wenn sie benötigt wird – zum Beispiel vor jeder USDT-Überweisung, die Ihr Kunde durchführt.
Stellen Sie sich einen Verkaufsautomaten vor: Sie überprüfen den Preis, werfen Geld ein und erhalten Ihren Artikel. Die API besteht aus denselben Tasten – nur Ihr Programm drückt sie.
Ihr Programm fragt die API, wie viel das benötigte Energiepaket gerade kostet.
Ihr Programm erstellt eine Bestellung und bezahlt diese – indem es TRX an die angegebene Adresse sendet oder Ihr TronBid-Guthaben belastet.
Innerhalb weniger Sekunden erscheint Energie auf dem Ziel-Wallet und USDT kann günstiger versendet werden.
Wichtig: Die API ist ein Werkzeug für einen Entwickler. Um es zu nutzen, muss jemand Code schreiben, der die Anfragen sendet.
Wenn niemand da ist, der Code schreibt, nutzen Sie den vorgefertigten Energiekauf auf der Website (Quick Rent) oder den Telegram-Bot @tronbid. Gleiches Ergebnis, nur manuell durchgeführt.
Ein vollständiges End-to-End-Beispiel für das einfachste Szenario (On-Chain). Vier Schritte und Energie ist auf dem Portemonnaie.
Nachfolgend erfahren Sie, was bei jedem Schritt passiert und was die API zurückgibt. Geben Sie Ihren API-Schlüssel, Ihre Adressen und Ihre Bestell-ID ein.
Senden Sie die Energiemenge und -dauer. Sie erhalten „price_trx“ zurück und wie viele Sekunden es gesperrt ist.
Senden Sie das Paket, Ihren idempotency_key und Ihre payer_address. Sie erhalten „pay_address“ (wo Sie bezahlen müssen), „amount_trx“ (wie viel) und „expires_at“ (bis wann).
Senden Sie genau amount_trx TRX von Ihrer payer_address an pay_address. Es handelt sich um eine reine TRON-Überweisung.
Fragen Sie den Status alle paar Sekunden ab, bis er delegiert wird. Das heißt, Energie wird an das Wallet delegiert – fertig.
{
"price_trx": "3.200000",
"available": true,
"save_percent": 62,
"expires_in_sec": 30
}{
"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..."
}# 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
}Kurze Erklärungen der in dieser Dokumentation verwendeten Wörter.
Was Sie vorbereiten müssen, bevor Sie Ihre erste Anfrage stellen.
Senden Sie eine Nachricht an @tronbid per Telegram – Sie erhalten einen Schlüssel, der an Ihr TronBid-Konto gebunden ist. Ohne sie werden Anfragen nicht angenommen.
Bestimmen Sie die Adresse (target_address), die Energie benötigt. Normalerweise ist es die Wallet, von der aus Ihre Kunden USDT senden.
Energie wird in Paketen verkauft (normalerweise 65.000 oder 131.000 Energie für 15 oder 60 Minuten). Rufen Sie die Live-Liste vom Katalogendpunkt ab, keine Authentifizierung erforderlich.
Für On-Chain – eine Wallet mit TRX zum Bezahlen. Für die Restzahlung: ein TronBid-Konto mit Guthaben und aktiviertem Saldomodus.
Mit der Quick Rent API kann Ihr Dienst TRON Energy automatisch mieten, sodass USDT TRC-20-Überweisungen und andere Smart-Contract-Anrufe weniger kosten als das Verbrennen von TRX.
Alle Endpunkte teilen sich eine Basis-URL.
https://tronbid.com/api/v2/quick-rentEs gibt zwei Möglichkeiten, eine Bestellung zu bezahlen. On-Chain ist die Standardeinstellung und erfordert keine Einrichtung. Die Restzahlung ist optional und muss für Ihren Schlüssel aktiviert sein.
Ohne Aktivierung gibt eine Anfrage mit payment_mode: balance 403 BALANCE_PAYMENT_NOT_ENABLED zurück. Um es zu aktivieren, wenden Sie sich an den TronBid-Support.
| Mode | So aktivieren Sie | Zahlung |
|---|---|---|
on-chain | Standard – payment_mode (oder „onchain“) weglassen | Senden Sie TRX von payer_address an pay_address |
balance | payment_mode: Guthaben + für Ihren Schlüssel aktiviert | Wird von Ihrem TronBid TRX-Guthaben abgebucht |
„energy_amount“ und „duration_minutes“ müssen mit einem aktiven Quick Rent-Paket übereinstimmen – normalerweise 65.000 oder 131.000 Energie und 15 oder 60 Minuten.
Rufen Sie jederzeit den aktuellen Katalog ab (keine Authentifizierung erforderlich):
curl -sS https://tronbid.com/api/public/quick-rent/skusSchritt 1 – POST/Angebot, um den Preis zu erfahren. Schritt 2 – POST /orders, um die Bestellung zu erstellen und pay_address, amount_trx und Expires_at zu erhalten. Schritt 3 – Senden Sie genau amount_trx TRX von Ihrer payer_address an pay_address. Schritt 4 – GET /orders/:id abfragen, bis der Status delegiert (oder fehlgeschlagen / abgelaufen / abgebrochen) ist.
target_address ist optional – wenn es weggelassen wird, wird Energie an payer_address delegiert.
Pro payer_address ist jeweils nur eine offene On-Chain-Bestellung (pending_paid) zulässig. andernfalls erhalten Sie 409 PENDING_PAYMENT_INTENT_EXISTS. Bei Unter-/Überzahlung kann die Endenergie abweichen – überprüfen Sie die effektive_Energiemenge in GET /orders/:id.
{
"energy_amount": 131000,
"duration_minutes": 15,
"idempotency_key": "your-unique-key-001",
"payer_address": "TPayerWalletXXXXXXXXXXXXXXXXXXXXXX",
"target_address": "TTargetWalletXXXXXXXXXXXXXXXXXXXXX"
}{
"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..."
}Schritt 1 – Holen Sie sich /balance, um Ihren TRX zu überprüfen. Schritt 2 – POST/Angebot für den Preis. Schritt 3 – POST/Bestellungen mit payment_mode: Saldo auf Lastschrift und Beginn der Delegierung. Schritt 4 – Abfragen von GET /orders/:id bis zur Delegierung (bei einem Delegierungsfehler schlägt die Delegierung fehl und TRX wird Ihrem Guthaben gutgeschrieben).
payer_address ist nicht erforderlich – das mit Ihrem API-Schlüssel verknüpfte Konto zahlt. Der Energiebetrag in der Antwort kann höher sein als die bestellte SKU (Preismatrix-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..."
}Jede Bestellung durchläuft diese Status. Fragen Sie GET /orders/:id ab, um ihm zu folgen.
| Status | Bedeutung |
|---|---|
pending_payment | Warten auf die Zahlung in der Kette |
delegating | Zahlung erhalten oder Restbetrag abgebucht; Delegation im Gange |
delegated | Energie delegiert |
cancelled | Vor der Zahlung storniert (in der Kette) |
expired | Das Zahlungsfenster in der Kette ist abgelaufen |
failed | Fehler (für den Restbetrag wird TRX erstattet) |
idempotency_key (8–128 Zeichen) ist eine eindeutige Bestell-ID auf Ihrer Seite. Das Wiederholen von POST /orders mit demselben Schlüssel (für denselben API-Client) gibt dieselbe Reihenfolge mit „duplicate“ zurück: true.
Verwenden Sie einen idempotency_key nicht für verschiedene Zahlungsmodi (On-Chain vs. Balance) wieder – das gibt 409 IDEMPOTENCY_PAYMENT_MODE_MISMATCH zurück.
Schätzen Sie, wie viel Energie eine Adresse für eine Übertragung benötigt. Geben Sie das Empfänger-Wallet weiter und ob es bereits USDT enthält.
/api/v2/quick-rent/calculator| Parameter | Type | Beschreibung | Example |
|---|---|---|---|
wallet_address | string | TRON-Adresse zur Analyse | TXXXXXXXX...XXXX |
has_usdt | boolean | null | Ob der Empfänger bereits USDT besitzt (beeinflusst die Energie). wahr, falsch oder weglassen. | 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}'Gibt den aktuellen Preis für ein Paket zurück: price_trx, Verfügbarkeit, save_percent und wie lange das Angebot gültig ist (expires_in_sec).
/api/v2/quick-rent/quote| Parameter | Type | Beschreibung | Example |
|---|---|---|---|
Energiemenge | int | Energiemenge aus dem aktiven Katalog | 131000 |
Dauer_Minuten | int | Mietdauer aus dem Katalog | 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}'Erstellt einen Mietauftrag. Übergeben Sie für die Kette „payer_address“ und zahlen Sie den zurückgegebenen „amount_trx“ an „pay_address“. Für den Saldo fügen Sie payment_mode: balance hinzu und das verknüpfte Konto wird sofort belastet.
target_address ist optional (standardmäßig payer_address). Beachten Sie die 409-Regeln: eine offene On-Chain-Bestellung pro Zahler und keine aktive Quick Rent-Delegation bereits am Ziel (ACTIVE_DELEGATION_EXISTS).
/api/v2/quick-rent/orders| Parameter | Type | Beschreibung | Example |
|---|---|---|---|
Energiemenge | int | Energiemenge aus dem Katalog | 131000 |
Dauer_Minuten | int | Mietdauer aus dem Katalog | 15 |
idempotency_key | string | Ihre eindeutige Bestell-ID (8–128 Zeichen) | partner-onchain-001 |
Zahlungsmodus | string | Optional. „onchain“ (Standard) oder „balance“. | balance |
Zahler_Adresse | string | On-Chain: Wallet, die TRX sendet. Wird für das Gleichgewicht nicht benötigt. | TPayer... |
Zieladresse | string | Optional. Wallet, die Energie empfängt (standardmäßig payer_address). | TTarget... |
{
"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..."
}{
"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",
"payer_address": "TPayer...",
"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..."
}'Gibt den aktuellen Status, Zahlungsmodus, Beträge, Adressen und Fehlercode/Fehlermeldung zurück, wenn etwas fehlgeschlagen ist. Die effektive_Energiemenge spiegelt die tatsächlich delegierte Energie nach Unter-/Überzahlung wider.
/api/v2/quick-rent/orders/:id| Parameter | Type | Beschreibung | Example |
|---|---|---|---|
ID | string | Bestell-ID (Pfadparameter) | 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"Storniert eine Bestellung, deren Zahlung noch aussteht (nur in der Kette). Sobald Energie delegiert wurde, kann der Auftrag nicht mehr storniert werden.
/api/v2/quick-rent/orders/:id/cancel| Parameter | Type | Beschreibung | Example |
|---|---|---|---|
ID | string | Bestell-ID (Pfadparameter) | uuid |
curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID/cancel" \
-H "Authorization: Bearer $API_KEY"Ändert das zahlende Wallet für eine ausstehende_Zahlung-On-Chain-Bestellung – nützlich, wenn der Kunde sich entscheidet, vor dem Senden von TRX mit einem anderen Wallet zu bezahlen.
/api/v2/quick-rent/orders/:id/set-payer| Parameter | Type | Beschreibung | Example |
|---|---|---|---|
ID | string | Bestell-ID (Pfadparameter) | uuid |
Zahler_Adresse | string | Neue kostenpflichtige Geldbörse | TNewPayer... |
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..."}'Gibt das TRX-Guthaben des TronBid-Kontos zurück, das mit Ihrem API-Schlüssel verknüpft ist (Ihr In-App-Guthaben, nicht ein On-Chain-Wallet). Erfordert den Authorization-Header.
/api/v2/quick-rent/balance{ "balance_trx": "150.500000" }curl -sS "$BASE_URL/api/v2/quick-rent/balance" \
-H "Authorization: Bearer $API_KEY"Fehler geben einen HTTP-Status und ein Fehlerfeld zurück. Hier sind diejenigen, denen Sie begegnen könnten.
| HTTP | error | Wann |
|---|---|---|
| 400 | Invalid body | Ungültige JSON-Daten oder Felder |
| 400 | INVALID_SKU / SKU_INACTIVE | Paket nicht verfügbar |
| 400 | INVALID_PAYER_ADDRESS / INVALID_TARGET_ADDRESS | Ungültige TRON-Adresse |
| 400 | INSUFFICIENT_BALANCE | Nicht genügend TRX im Gleichgewicht (Balance-Modus) |
| 401 | Unauthorized | Fehlender oder ungültiger API-Schlüssel |
| 403 | BALANCE_PAYMENT_NOT_ENABLED | Die Restzahlung ist für Ihren Schlüssel nicht aktiviert |
| 409 | PENDING_PAYMENT_INTENT_EXISTS | Für diesen Zahler existiert bereits ein offener On-Chain-Auftrag |
| 409 | ACTIVE_DELEGATION_EXISTS | Target verfügt bereits über eine aktive Quick Rent-Delegation |
| 409 | POOL_ENERGY_INSUFFICIENT | Im Moment gibt es keine kostenlose Poolenergie |
| 409 | IDEMPOTENCY_PAYMENT_MODE_MISMATCH | Gleicher idempotency_key mit einem anderen payment_mode |
| 429 | Too Many Requests | Ratenbegrenzung |
| 503 | — | Der Dienst ist vorübergehend nicht verfügbar. Versuchen Sie es später noch einmal |
Häufige Situationen und was zu tun ist, in einfachen Worten.
Stellen Sie sicher, dass der überwiesene Betrag genau „amount_trx“ entspricht und dass das Geld genau von „payer_address“ an „pay_address“ gesendet wurde. Die Überweisung muss vor „expires_at“ eintreffen. Der Status wird normalerweise innerhalb einer Minute nach der Netzwerkbestätigung aktualisiert – fragen Sie weiterhin GET /orders/:id ab.
Die Delegation war nicht erfolgreich. Bei Restzahlungen wird der TRX automatisch Ihrem Guthaben gutgeschrieben. Der Grund liegt im Fehlercode und der Fehlernachricht von GET /orders/:id. Sie können eine neue Bestellung erstellen.
Für diese payer_address liegt bereits eine unbezahlte On-Chain-Bestellung vor. Bezahlen Sie es, warten Sie, bis es abläuft (expires_at), oder stornieren Sie es über /orders/:id/cancel und erstellen Sie dann ein neues.
Für Ihren Schlüssel ist die Restzahlung nicht aktiviert. Wenden Sie sich an den TronBid-Support, um es zu aktivieren, oder verwenden Sie On-Chain (Standardeinstellung).
Zu viele Anfragen in kurzer Zeit. Verringern Sie die Abfragehäufigkeit (z. B. einmal alle 3 Sekunden) und versuchen Sie es später erneut.
Bei Unter-/Überzahlung in der Kette ändert sich der Endbetrag. Überprüfen Sie die effektive_Energiemenge in GET /orders/:id – das ist die tatsächlich delegierte Energie.
Benötigen Sie API-Zugriff, höhere Limits oder eine aktivierte Restzahlung? Kontaktieren Sie uns und wir helfen Ihnen.