Tovanix
Tovanix

API zur TRON-Energiemiete

Mieten Sie TRON-Energie programmatisch, statt TRX für Gebühren zu verbrauchen. So sparen Sie 70–80 % bei jeder TRC-20-Überweisung.

  • Bestellung: Empfängeradresse, Energiemenge und Mietdauer angeben. Die Delegation erfolgt innerhalb von Sekunden
  • Bestellabfragen: Delegationsstatus und Ablaufdatum nach Bestell-ID oder Adresse abfragen
  • Preise: aktuelle Stückpreise und Preisstufen zur Kostenplanung
  • Webhooks: Ereignisse für erfolgreiche Delegation und Ablauf, mit HMAC signiert

GET / POST /api/v1/energy/*

Authentifizierung

Die Energiemiet-API authentifiziert mit Ihrem Nutzer-API-Schlüssel. Fügen Sie jeder Anfrage folgende Header hinzu:

Melden Sie sich in der Konsole an, öffnen Sie Werkzeuge und Einstellungen → API-Verwaltung und erstellen sowie aktivieren Sie einen API-Schlüssel, um X-API-Key und X-Secret-Key zu erhalten.

Signierte Aufrufe kostenpflichtiger Endpunkte

Auftragserstellung, Einmalauftrag und Rückforderung sind kostenpflichtige Endpunkte. Neue API-Schlüssel verlangen dafür standardmäßig Signaturen (X-Key-ID / X-Timestamp / X-Nonce / X-Sign-Version / X-Signature); unten steht ein vollständiges Beispiel zur Auftragserstellung. Abfrage-Endpunkte akzeptieren weiterhin allein X-API-Key + X-Secret-Key. Bei deaktivierter Signaturpflicht für kostenpflichtige Vorgänge und sensible Daten akzeptieren auch kostenpflichtige Endpunkte den einfachen X-Secret-Key; dies wird nicht empfohlen.

Übersicht

USDT-Überweisungen auf TRON verbrauchen Energie. Adressen ohne eingefrorene TRX zahlen etwa 6.5-13 TRX Gas je Transaktion. Mit gemieteter Energie nutzt die Überweisung diese Energie, statt dafür TRX zu verbrennen; wie viel Sie sparen, hängt vom Mietpreis bei der Bestellung ab.

USDT-Überweisung an Adresse mit USDT-Guthaben: etwa 65.000 Energie

USDT-Überweisung an Adresse ohne bisherigen USDT-Empfang: etwa 135.000 Energie

Plattforminformationen abrufen

GET /api/v1/energy/info

Öffentliche Informationen zur Energiemiete abrufen, einschließlich verfügbarer Energie, Preisstufen und Limits.

Kontoguthaben abfragen

GET /api/v1/energy/balance

Guthaben des Kontos abfragen, zu dem dieser API-Schlüssel gehört. Energiemiete umfasst häufige kleine Zahlungen; unzureichendes Guthaben kommt regelmäßig vor. Prüfen Sie vor Sammelaufträgen und richten Sie eine Warnung bei niedrigem Guthaben ein.

Mietzeiträume auflisten (Endpunkt)

GET /api/v1/energy/periods

Gibt unterstützte Zeitraumwerte zurück. Werte außerhalb der Liste werden mit 400 abgewiesen; es wird kein Auftrag erstellt.

Preisschätzung

GET /api/v1/energy/price

Mietkosten für Zeitraum und Energiemenge schätzen. Gibt API-spezifischen Preis in TRX zurück.

Energieverbrauch schätzen

GET /api/v1/energy/estimate-energy

Benötigte Energie für eine USDT-Überweisung an eine bestimmte Adresse schätzen.

Mietauftrag erstellen

POST /api/v1/energy/order

Energiemietauftrag erstellen; Gebühr wird vom Kontoguthaben in USD abgebucht.

Antwortfelder

Bei unzureichendem Guthaben wird code: 400, message: "Insufficient account balance, please top up first" zurückgegeben

Einmaliger Energieauftrag

POST /api/v1/energy/order/onetime

Einzelauftrag nach Strategie je Transaktion erstellen; energy_amount wird vom System automatisch festgelegt.

Auftragsliste abfragen

GET /api/v1/energy/orders

Ihre Energiemietaufträge abfragen.

Einzelauftrag abfragen

GET /api/v1/energy/order/:serial

Auftragsdetails abfragen und den neuesten Status synchronisieren.

Auftrag anhand Ihrer eigenen Transaktionsnummer abfragen

GET /api/v1/energy/order/by-trade-no/:out_trade_no

Auftrag anhand Ihrer eigenen out_trade_no suchen; unsere Seriennummer ist nicht erforderlich.

⚠️ Bei einer Zeitüberschreitung liefert der Erstellungsendpunkt 504. Dann haben Sie nur out_trade_no: Unsere Seriennummer ist in der Zeitüberschreitungsantwort nicht enthalten. Genau dafür dient dieser Endpunkt; rufen Sie das endgültige Ergebnis mit derselben out_trade_no ab.

Auftrag zurücknehmen

POST /api/v1/energy/order/reclaim

Nicht abgelaufenen Energiemietauftrag vorzeitig zurücknehmen.

Callback für Auftragsergebnisse

Für Aufträge mit callback_url (einschließlich Einmalaufträgen) sendet die Plattform das Ergebnis einmal an diese URL, sobald der Auftrag erstmals als erfolgreich (status=40) oder fehlgeschlagen (status=41) feststeht. Ob dies durch Echtzeit-Statusmeldung, Abfrage, Abgleich oder Wiederherstellung eines nicht gespeicherten Auftrags bestätigt wird: Jeder Auftrag wird nur einmal übermittelt; fehlgeschlagene Zustellungen werden automatisch wiederholt. Ausnahme: Die Erstellung lieferte 504 mit unbekanntem Ergebnis (intern als Platzhalter mit Seriennummer beginnend mit LOCAL- gespeichert). Solche Aufträge werden manuell geklärt und nie automatisch übermittelt; prüfen Sie sie über Ihre eigene Auftragsnummer. Die Plattform sendet und signiert die Callbacks; das frühere Callback-Format wird nicht mehr verwendet. Bestehende Integrationen müssen Parsing und Signaturprüfung an diesen Abschnitt anpassen.

Die Anfrage ist ein POST mit Content-Type: application/json. Der Inhalt ist ein flaches JSON-Objekt, dessen Werte alle Zeichenfolgen sind (einschließlich status, energy_amount und timestamp); Preisfelder fehlen. Die Plattform folgt keinen Weiterleitungen, und jede Anfrage hat eine Zeitgrenze von 10 Sekunden.

Signatur prüfen

Der Algorithmus entspricht den Zahlungs-Callbacks: Alle Felder mit nicht leerem Wert außer sign nach Feldnamen in ASCII-Reihenfolge sortieren, als k1=v1&k2=v2&… verbinden und HMAC-SHA256 berechnen; das Ergebnis ist Hexadezimaltext in Kleinbuchstaben. Als Schlüssel dient der Secret Key des zur Auftragserstellung verwendeten API-Schlüssels; bei Zahlungs-App-Zugangsdaten das Push Secret der App (WebhookSecret, auf der App-Detailseite in der Konsole — derselbe Schlüssel wie bei Zahlungs-Callbacks). Ältere Apps ohne erzeugtes Push Secret verwenden den App Key.

Die Benachrichtigung enthält kein sign, wenn der Plattform-Support den Auftrag für Sie angelegt hat (kein zugehöriger Schlüssel) oder der verwendete API-Schlüssel bzw. die Zahlungs-App inzwischen gelöscht wurde. Bei einer Benachrichtigung ohne sign vor jeder Verarbeitung den Status über den Auftragsabfrage-Endpunkt prüfen.

Antwort und Wiederholungen

Jeder 2xx-Status gilt als zugestellt; der Antwortinhalt wird nicht geprüft. Andere Statuscodes, Zeitüberschreitungen, Verbindungsfehler oder Weiterleitungen gelten als Fehlschlag. Die Plattform wiederholt nach 30 Sekunden, 1 Minute, 2 Minuten und 5 Minuten, danach alle 10 Minuten, bis zu 10 Wiederholungen (Ende nach etwa 70 Minuten). Dabei wird exakt derselbe Inhalt einschließlich notify_id und sign erneut gesendet.

Bricht das Netzwerk nach Verarbeitung durch Ihren Server ab, bevor die Plattform 2xx erhält, wird derselbe Auftrag erneut übermittelt. Deduplizieren Sie nach notify_id oder serial und verhindern Sie Nebenwirkungen bei doppelter Verarbeitung. Die Benachrichtigung ist nicht die einzige verlässliche Quelle: Bleibt sie aus oder scheitert die Zustellung endgültig, prüfen Sie das Ergebnis über GET /api/v1/energy/order/:serial oder Ihre eigene Auftragsnummer.

Mietzeiträume

Dies sind alle aktuell unterstützten Zeiträume. Sie können sie auch über GET /api/v1/energy/periods abrufen. Andere Werte liefern 400; kein Auftrag wird erstellt.

Häufig gestellte Fragen

Wie viel spart die Energiemiet-API tatsächlich?

Eine direkte Zahlung der Gebühren mit TRX kostet für eine TRC-20-USDT-Überweisung gewöhnlich etwa 6.5-13 TRX. Energiemiete senkt diesen Betrag um 70–80 %. Bei Sammelüberweisungen wächst der Unterschied.

Wie schnell ist die Delegation, und kann ich eine andere Adresse versorgen?

Die Delegation erfolgt innerhalb von Sekunden. Die Empfängeradresse ist die im Aufruf angegebene Adresse und muss nicht zum bestellenden Konto gehören. So können Sie beliebige Geschäftsadressen in Sammelaufträgen mit Energie versorgen.

Verwandte Seiten: TRON-Energiemiete · API-Dokumentation · Krypto-Zahlungen über mehrere Blockchains

Wird geladen…