Wenn Ihre App, Ihre Börse oder Ihr Bot USDT (TRC-20) in großem Umfang versendet, möchten Sie Energie nicht von Hand kaufen. Mit dem offiziellen TronSave SDK schätzen, kaufen, verlängern und verfolgen Sie Energie-Orders direkt aus Ihrem Backend – in Node.js, Python, Rust, Java oder PHP. Dieser Leitfaden führt Sie von der Installation bis zu Ihrer ersten On-Chain-Energie-Order.
Die SDKs
Alle SDKs nutzen die v2 API und kapseln dieselben Endpunkte – Sie erhalten also in jeder Sprache dieselben Operationen:
| Sprache | Paket | Installation | Voraussetzung |
|---|---|---|---|
| TypeScript / JS | tronsave-sdk |
npm install tronsave-sdk |
Node.js 18+ |
| Python | tronsave |
pip install tronsave |
Python 3.9+ |
| Rust | tronsave |
cargo add tronsave |
— |
| Java | io.tronsave:sdk |
Maven / Gradle | — |
| PHP | tronsave/sdk |
composer require tronsave/sdk |
PHP 8.1+ |
Die Pakete für Rust, Python, Java und PHP liegen alle in Version 2.0.0 vor. Für Java lauten die Koordinaten io.tronsave:sdk:2.0.0 – fügen Sie sie in der pom.xml als Dependency hinzu oder in der build.gradle als implementation 'io.tronsave:sdk:2.0.0'.
Was jedes SDK abdeckt
Der Funktionsumfang ist bewusst schlank. Egal welche Sprache Sie wählen, Sie erhalten dieselben sieben Operationen:
- Estimate Buy Resource – den Preis eines Kaufs ermitteln, bevor Sie sich festlegen.
- Buy Resource – die Order für Energie oder Bandbreite aufgeben; liefert eine Order-ID zurück.
- Get Order / Get Orders – den Status einer Order oder Ihre Order-Historie abrufen.
- Get Order Book – das aktuelle Angebot als Preisstufen lesen, die günstigste zuerst.
- Get User Info – internes Kontoguthaben und Einzahlungsadresse.
- Get Extendable Delegates – Delegationen auflisten, die verlängert werden können.
- Extend Request – eine bestehende Delegation verlängern, statt eine neue Order zu kaufen.
Das letzte Paar ist wichtiger, als es aussieht. Wenn ein Empfänger bereits delegierte Energie hat und sie nur länger halten soll, ist die Verlängerung der richtige Weg – siehe den Leitfaden zur Extend-Funktion.
Schnellstart (Node.js)
Am schnellsten geht es mit dem API-Key-Ablauf: SDK-Instanz erstellen, Kosten schätzen, dann die Order aufgeben. Einen API-Key erhalten Sie im TronSave Dashboard (siehe Authentifizierung).
import { TronsaveSDK } from "tronsave-sdk";
const main = async () => {
const sdk = new TronsaveSDK({ network: "mainnet", apiKey: "your_api_key" });
const userInfo = await sdk.getUserInfo();
// Estimate cost for 65,000 ENERGY for 1 hour (one USDT transfer)
const estimate = await sdk.estimateBuyResource({
receiver: "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
resourceType: "ENERGY",
durationSec: 3600,
resourceAmount: 65000,
});
if (estimate.estimateTrx > Number(userInfo.balance)) throw new Error("Insufficient balance");
const { orderId } = await sdk.buyResource({
receiver: "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
resourceType: "ENERGY",
durationSec: 3600,
resourceAmount: 65000,
});
await new Promise((r) => setTimeout(r, 5000)); // wait ~5s to fill
const order = await sdk.getOrder(orderId);
console.log(order.fulfilledPercent < 100 ? "Not filled" : "Filled");
};
main();
Tipp: Nutzen Sie network: "testnet" (Nile), um ohne echte TRX zu entwickeln, und wechseln Sie für die Produktion auf "mainnet".
Zwei Details sollten Sie vor dem Ausführen kennen. userInfo.balance kommt in SUN als String zurück – 1 TRX entspricht 1.000.000 SUN –, deshalb wird der Wert beim Vergleich umgewandelt. Und durationSec ist optional: Lassen Sie den Parameter weg, gilt standardmäßig eine Laufzeit von 259.200 Sekunden, also 3 Tagen.
Dieselbe Aufgabe in Python
Das Python-Paket wird mit pip install tronsave installiert und bietet denselben Ablauf Schätzen → Kaufen → Verfolgen; die Methodensignaturen pro Sprache finden Sie in der SDK-Referenz. Wenn Sie lieber genau sehen möchten, welche HTTP-Aufrufe darunter stattfinden, hier dieselbe Aufgabe – schätzen, kaufen, dann abfragen – direkt gegen die v2-Endpunkte geschrieben:
import time, requests
API = "https://api.tronsave.io" # testnet: https://api-dev.tronsave.io
HEADERS = {"apikey": "your_api_key", "Content-Type": "application/json"}
ORDER = {
"receiver": "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"resourceType": "ENERGY",
"resourceAmount": 65000,
"durationSec": 3600,
"unitPrice": "MEDIUM",
}
estimate = requests.post(f"{API}/v2/estimate-buy-resource", json=ORDER).json()["data"]
print(estimate["estimateTrx"] / 1e6, "TRX", estimate["availableResource"], "available")
order = requests.post(f"{API}/v2/buy-resource", headers=HEADERS,
json={**ORDER, "options": {"allowPartialFill": True,
"maxPriceAccepted": 100}}).json()
order_id = order["data"]["orderId"]
time.sleep(5)
detail = requests.get(f"{API}/v2/order/{order_id}", headers=HEADERS).json()["data"]
print("Filled" if detail["fulfilledPercent"] == 100 else "Not filled")
Dieselben drei Schritte, dieselben Feldnamen, dieselbe Antwortstruktur. Der Mehrwert des SDK liegt in Typisierung und Wiederholungsversuchen, nicht in einer anderen API – wählen Sie also, was zu Ihrem Stack passt. Ein ausführlicheres Python-Skript mit Order-Book-Dimensionierung und Fehlerzweigen finden Sie unter TRON-Energie mit Python kaufen.
Vor dem Kauf schätzen
Der Schätzaufruf verdient einen eigenen Absatz, denn seine Antwort verrät Ihnen zwei verschiedene Dinge. estimateTrx sind die Kosten in SUN. availableResource zeigt, wie viel der Markt im Moment tatsächlich liefern kann. Ist availableResource kleiner als die angefragte resourceAmount, kann die Order in diesem Moment nicht vollständig ausgeführt werden – und was dann passiert, legen Sie über options fest: allowPartialFill: true, um zu nehmen, was verfügbar ist, oder onlyCreateWhenFulfilled: true, um alles unterhalb einer vollständigen Ausführung abzulehnen. Bei Bots mit vielen Wiederholungen verhindert preventDuplicateIncompleteOrders: true, dass ein wiederholter Aufruf identische offene Orders anhäuft.
Fehler und Limits
Die Endpunkte erlauben 15 Anfragen pro Sekunde; darüber hinaus erhalten Sie HTTP 429 mit "Rate limit reached", und ein einfaches Backoff von 1 s/2 s/4 s reicht aus. Anwendungsfehler kommen als error: true mit einem maschinenlesbaren Code in message – INVALID_API_KEY, INTERNAL_BALANCE_ACCOUNT_TOO_LOW, PRICE_EXCEED_MAX_PRICE_REQUIRED, CANNOT_FULFILLED. Verzweigen Sie anhand des Codes; der Wortlaut kann sich ändern.
TronSave aus einem KI-Agenten steuern
Ist Ihre Integration ein Agent statt eines Dienstes, stellt TronSave auch einen MCP-Server bereit, gehostet unter https://mcp.tronsave.io/mcp über Streamable HTTP (mit https://mcp.tronsave.io/testnet/mcp für das Testnet). Er bietet 53 MCP-Tools (Serverversion 1.3.0, November 2026) – tronsave_estimate_buy_resource, tronsave_list_order_books, tronsave_internal_order_create und weitere – mit Sitzungen per API-Key oder Wallet-Signatur. Richten Sie einen beliebigen MCP-kompatiblen Client auf den Endpunkt; unser Leitfaden zum TronSave MCP-Server erklärt Login, die zwei Tool-Familien und das Sicherheitsmodell.
Lieber direkt per HTTP? Die SDKs kapseln dieselben Endpunkte der API – siehe unseren Leitfaden zur API-Automatisierung, die Übersicht der TronSave-Order-Typen und, für hohe Volumen, Energie in großen Mengen kaufen.
FAQ
Brauche ich einen API-Key?
Der API-Key-Ablauf ist am einfachsten; Sie können auch mit einem Private Key signieren. Einen Key erhalten Sie im Dashboard. Der Unterschied liegt in der Verwahrung: Ein API-Key zahlt aus einem vorab aufgeladenen internen TronSave-Konto, während der Ablauf mit signierten Transaktionen bei jedem Kauf aus Ihrer eigenen Wallet bezahlt und TronWeb benötigt.
Welche Sprachen werden unterstützt?
Node.js/TypeScript, Python, Rust, Java und PHP – alle auf der v2 API. Sprachspezifische Anleitungen gibt es für Python, Java, PHP und Rust.
Wie viel Energie braucht eine USDT-Überweisung?
Rund 65.000 (≈130.000, wenn der Empfänger noch nie USDT gehalten hat). Mehr dazu unter wie viel Energie eine USDT-Überweisung benötigt.
Kann ich testen, ohne echte TRX auszugeben?
Ja. Setzen Sie network: "testnet" (oder richten Sie die Basis-URL auf https://api-dev.tronsave.io), um gegen Nile zu arbeiten. Keys, Guthaben und Orders sind pro Umgebung getrennt – erstellen Sie daher einen Nile-Key unter testnet.tronsave.io; ein Mainnet-Key wird abgelehnt. Shasta wird nicht unterstützt.
Jetzt loslegen: Lesen Sie die TronSave-Dokumentation und holen Sie sich einen API-Key im Market-Dashboard.
Python-Entwickler? Hier ist die sprachspezifische Anleitung: TRON-Energie mit Python kaufen (vollständiges, lauffähiges Skript).


