TRON API: USDT-TRC20-Zahlungen über REST
Senden und empfangen Sie USDT-TRC20 und TRX über eine REST-API. Erstellen Sie Adressen, sponsern Sie Netzwerkgebühren und erhalten Sie Deposit-Webhooks, ohne eine TRON-Node zu betreiben.
Die TRON-API von Chaingateway ist eine REST-API, die TRX, TRC-10- und TRC-20-Token einschließlich USDT-TRC20 über 40 Endpoints sendet und empfängt. Sie importiert Adressen, sendet Transfers, schätzt Gebühren und schickt einen signierten Webhook an Ihren Server, wenn ein Deposit landet. Eine Node ist nicht nötig, und der kostenlose 7-Tage-Test startet ohne KYC.
USDT-TRC20 ist der Token, um den es auf dieser Seite geht. Nimmt Ihr Produkt Stablecoin-Deposits an oder sendet Auszahlungen, deckt die TRON-API beide Richtungen ab: Adressen, Transfers, Gebührenschätzungen und Deposit-Webhooks.
TRON ist auch die vollständigste Chain im Produkt. Über schlichte Transfers hinaus gibt es Staking-Aufrufe, einen Fee-Estimator und gesponserte Gebühren für Wallets, die kein TRX halten. TronFuel ist der empfohlene Weg für gesponserte Gebühren; die Paymaster-Endpoints sind veraltet (deprecated).
Die Authentifizierung ist ein Bearer-Token im Authorization-Header. Die Basis-URL ist https://app.chaingateway.io, und das Hinzufügen von X-Network: testnet zu jedem Request schaltet ihn auf das Testnetzwerk.
Wie erreicht ein USDT-TRC20-Deposit meine Anwendung?
Ein USDT-TRC20-Deposit erreicht Ihre Anwendung als signierter Webhook: Sie importieren über die REST-API eine Adresse, registrieren dafür einen Webhook, und die API schickt jeden eingehenden Transfer an Ihren Server.
Was die TRON-Endpoints abdecken
Vierzig Routen, ein Zahlungs-Lifecycle. Die Auswahl unten zeigt die sechs Gruppen, die eine Integration tatsächlich kombiniert; der Rest – Guthaben-, Block- und Decoded-Transaction-Reads, Contract-Informationen, Adressverwaltung – steht in den Docs. Alle liegen unter https://app.chaingateway.io und erwarten den Bearer-Token im Authorization-Header. Die Gruppierung folgt dem, wie Integrationen in der Praxis wachsen: Die meisten starten mit Transactions und Webhooks, fügen Queries für Fee-Logik hinzu, und greifen zu Staking oder gesponserten Gebühren, sobald Volumen Gebühren zu einem beachtenswerten Posten macht.
Transaktionen
| Endpoint | Was er tut |
|---|---|
POST /api/v2/tron/transactions | TRX senden |
POST /api/v2/tron/transactions/trc20 | TRC-20-Token wie USDT senden |
POST /api/v2/tron/transactions/trc10 | TRC-10-Token senden |
POST /api/v2/tron/transactions/trc721 | TRC-721-NFTs senden |
POST /api/v2/tron/transactions/build | Eine unsignierte TRX-Transaktion zum lokalen Signieren bauen |
POST /api/v2/tron/transactions/trc20/build | Eine unsignierte TRC-20-Transaktion zum lokalen Signieren bauen |
POST /api/v2/tron/transactions/broadcast | Eine selbst signierte Transaktion broadcasten |
Sieben Endpoints, weil es zwei Sendemodi gibt. Die ersten vier signieren für Sie mit einem importierten Key. Die letzten drei teilen den Prozess in Bauen, lokal Signieren, Broadcasten, für Teams, deren Keys ihre eigene Hardware nie verlassen.
Adressen
| Endpoint | Was er tut |
|---|---|
POST /api/v2/tron/addresses |
Neue Adresse erstellen |
POST /api/v2/tron/addresses/import |
Private Key importieren, damit die API für diese Adresse signieren kann |
Der Import wird nur für Wallets gebraucht, von denen Sie senden. Das Beobachten einer Adresse auf Deposits funktioniert ohne jeden Key.
Staking
| Endpoint | Was er tut |
|---|---|
POST /api/v2/tron/freeze |
TRX staken, um Bandwidth oder Energy zu generieren |
POST /api/v2/tron/unfreeze |
Gestaktes TRX freigeben |
POST /api/v2/tron/delegate |
Gestakte Ressourcen an eine andere Adresse routen |
POST /api/v2/tron/undelegate |
Delegierte Ressourcen zurückholen |
Paymaster (Legacy)
| Endpoint | Was er tut |
|---|---|
POST /api/v2/tron/paymaster |
Eine gesponserte Gebühren-Anfrage erstellen |
GET /api/v2/tron/paymaster |
Ihre Paymaster-Anfragen auflisten |
POST /api/v2/tron/paymaster/estimate |
Eine gesponserte Transaktion vor dem Senden bepreisen |
GET /api/v2/tron/paymaster/balance |
Ihr verbleibendes Paymaster-Guthaben prüfen |
Die Paymaster-Endpoints bleiben für bestehende Integrationen dokumentiert, aber die Entwickler-Docs markieren das Feature als deprecated und empfehlen TronFuel für neue Setups – eine Energy-Rental-API, die demselben Zweck dient: Transfers aus Wallets ohne TRX, zu gemieteten Energy-Preisen statt dem Burn-Preis.
Queries
| Endpoint | Was er tut |
|---|---|
GET /api/v2/tron/chainparameters |
Live-Netzwerkparameter lesen, z. B. den Energy-Preis in Sun |
Chain-Parameter ändern sich per Governance-Abstimmung, lesen Sie sie also zur Laufzeit statt Fee-Konstanten hart zu kodieren, die ein durchgekommener Vorschlag still ungültig macht.
Webhooks
| Endpoint | Was er tut |
|---|---|
POST /api/v2/tron/webhooks |
Einen Webhook für eine Adresse erstellen |
GET /api/v2/tron/webhooks/notifications |
Vergangene Webhook-Benachrichtigungen auflisten |
GET /api/v2/tron/webhooks/notifications/failed |
Fehlgeschlagene Zustellungen auflisten |
POST /api/v2/tron/webhooks/notifications/{id}/retry |
Eine fehlgeschlagene Zustellung erneut senden |
Es gibt zwei Wege, Keys über all das hinweg zu handhaben. Importieren Sie einen Private Key einmal und senden Sie danach mit einem einzigen Aufruf. Oder behalten Sie Keys auf Ihrer eigenen Infrastruktur: bauen Sie die rohe Transaktion mit einem der /build-Endpoints, signieren Sie sie lokal und schieben Sie sie über /transactions/broadcast raus. Im zweiten Modus verlässt kein Key-Material je Ihre Server; der Self-Signing-Abschnitt unten geht den Flow durch.
USDT auf TRON: was Sie wissen sollten
USDT auf TRON ist ein TRC-20-Token. Seine Transfers sind Smart-Contract-Aufrufe und verbrauchen Energy, wie der Gebührenabschnitt weiter unten erklärt. Die USDT-Contract-Adresse TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t ist die, die in den Beispielen auf dieser Seite verwendet wird.
Dasselbe Token-Symbol gibt es auf mehreren Chains, beschriften Sie also bei jeder Deposit-Adresse das Netzwerk. Ein USDT-Transfer, der auf einer anderen Chain gesendet wird, kommt an einer TRON-Adresse nicht an.
Das geteilte Request-Schema erlaubt Ihnen, die anderen Chains später ohne neuen Code hinzuzufügen.
USDT (TRC-20) mit einem Request senden
Ein TRC-20-Transfer nimmt den Token-Contract, Sender, Empfänger und Betrag, plus das Wallet-Passwort, das Sie beim Importieren des Keys gesetzt haben. Sie liefern das, die API handhabt Fee-Schätzung und Broadcasting.
curl -X POST https://app.chaingateway.io/api/v2/tron/transactions/trc20 \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"contractaddress": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"from": "TYourHotWalletAddress",
"to": "TRecipientAddress",
"amount": 25,
"password": "YourWalletPassword"
}'Das ist der ganze Transfer – Konto erstellen und ihn im Testnet ausführen, bevor Sie Mainnet-TRX anfassen.
Was kostet ein TRON-Transfer an Energy und Bandwidth?
Ein USDT-Transfer kostet etwa 6,4 TRX an Energy, wenn der Empfänger bereits USDT hält, und etwa 13,4 TRX, wenn nicht, dazu Bandwidth, die bis zu 600 Punkten am Tag kostenlos ist.
TRON misst zwei Ressourcen. Bandwidth deckt schlichte Transfers ab und ist bis zu 600 Punkten am Tag kostenlos. Energy hat kein kostenloses Kontingent und greift, wann immer ein Smart Contract läuft, weshalb ein USDT-Transfer, ein TRC-20-Contract-Aufruf, immer mehr kostet als reines TRX zu senden.
TRON hat keinen einzelnen Gas-Preis. Zu wissen, welche der beiden Ressourcen Ihre Transaktion verbraucht, ist der Unterschied zwischen vorhersehbaren Gebühren und überraschenden Support-Tickets.
Bandwidth wird bei jeder Transaktion berechnet und folgt der Byte-Größe. Jedes Konto bekommt 600 kostenlose Punkte am Tag; ein reiner TRX-Transfer wiegt 250 bis 300 Bytes, sodass gelegentliche TRX-Transfers gar nichts kosten. Jenseits des kostenlosen Kontingents verbrennt das Netzwerk 0,001 TRX pro Punkt, rund 0,35 TRX für einen typischen TRC-20-Transfer.
Energy greift nur, wenn ein Smart Contract läuft, und hat kein tägliches Freikontingent. Ein USDT-Transfer ist ein Contract-Aufruf, der TRC-20-Contract aktualisiert seine interne Guthabentabelle, braucht also Energy zusätzlich zu Bandwidth.
Seit Governance-Proposal #104 im August 2025 in Kraft trat, kostet eine Energy-Einheit 100 Sun, halbiert von 210. Ein Transfer an eine Adresse, die bereits USDT hält, braucht etwa 64.000 Energy, was 6,4 TRX entspricht. Ein Transfer an eine Adresse, die nie USDT gehalten hat, schreibt einen neuen Storage-Eintrag, und neuer State kostet etwa doppelt so viel Energy wie ein Update: rund 134.000 Einheiten, oder 13,4 TRX.
Vor dem Senden machen zwei Tools die Zahlen greifbar. Der TRON-Fee-Calculator berechnet Bandwidth, Energy und die TRX-Gesamtsumme für eine bestimmte Transaktion, und GET /api/v2/tron/chainparameters gibt die Live-Einheitenpreise zurück, sodass Ihr Code nie eine Konstante einbrennt, die die nächste Governance-Abstimmung ändert. Der Fee-Guide behandelt die Mechanik ausführlich.
Wie kann ich USDT aus einer Wallet senden, die kein TRX hält?
Lassen Sie einen Sponsor die Energy zahlen, und eine Wallet ohne TRX kann trotzdem USDT senden. Jeder TRC-20-Transfer braucht Energy, und bei den meisten Sendern stammt sie aus dem eigenen TRX-Guthaben. Diese Annahme bricht in zwei häufigen Situationen, und beide erzeugen operativen Schmerz, bis Sie sie strukturell fixen.
Ihre eigene Deposit-Wallet-Flotte
Jede Wallet, die Gelder an eine Hot Wallet weiterleitet, braucht ihr eigenes TRX-Guthaben für den Sweep, und mit ein paar Tausend Wallets wird das Auffüllen zu einem eigenen Job, komplett mit eigenen Fee-Kosten für die Top-up-Transfers. Gesponserte Gebühren beseitigen diesen Job. Der empfohlene Weg dafür heute ist TronFuel, das Energy gebündelt von Stakern mietet – derselbe Mechanismus, den der Fee-Guide beschreibt: Wer gestakte oder gemietete Energy nutzt, statt TRX zu verbrennen, verbrennt pro Transfer weniger TRX. Chaingateways Legacy-Paymaster-Endpoints tun dasselbe und bleiben für bestehende Integrationen verfügbar.
Ihre Endkunden
Ein Nutzer hält 200 USDT in einer Self-Custody-Wallet und null TRX; das USDT kam von einer Börse oder von einer anderen Person, und niemand hat ihm gesagt, dass eine zweite Währung nötig ist, um es zu bewegen. Versucht er, Sie zu bezahlen oder abzuheben, scheitert der Transfer. Aus Sicht des Nutzers ist das Geld gefangen.
Aus Sicht Ihrer Support-Warteschlange ist es ein wiederkehrendes Ticket, das kein FAQ-Eintrag vollständig entschärft, weil die Lösung, „kauf erst etwas TRX auf einer Börse“, genau die Reibung ist, die der Kunde mit Stablecoins vermeiden wollte. Ein gesponserter Transfer beendet das: Sie reichen den Transfer ein, der Sponsor deckt Energy und Bandwidth, die Kosten landen auf Ihrem Konto, und der Kunde erfährt nie, was TRX ist. Für Checkout- und Abhebungs-Flows entfernt diese eine Änderung den häufigsten Fehlermodus von TRC-20-Zahlungen.
Einen gesponserten Transfer bepreisen und erstellen
Die Paymaster-Endpoints sind veraltet und bleiben für bestehende Integrationen verfügbar; TronFuel ist der empfohlene Weg für neue. Bepreisen Sie mit dem Paymaster eine gesponserte Transaktion zuerst, erstellen Sie sie dann:
# 1. Gebühr schätzen
curl -X POST https://app.chaingateway.io/api/v2/tron/paymaster/estimate \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"type": "TRC20", "contractaddress": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", "from": "TDepositWallet", "to": "THotWallet", "amount": "500"}'
# 2. Paymaster-Anfrage erstellen
curl -X POST https://app.chaingateway.io/api/v2/tron/paymaster \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"type": "TRC20", "contractaddress": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", "from": "TDepositWallet", "to": "THotWallet", "amount": "500", "password": "YourWalletPassword"}'
GET /api/v2/tron/paymaster listet jede Anfrage, die Sie erstellt haben, und meldet ihren Status von pending bis completed oder failed, und GET /api/v2/tron/paymaster/balance zeigt das übrige Sponsoring-Guthaben – zusammen decken sie den Abgleich ab.
Self-Signing: Keys verlassen nie Ihre Server
Einen Private Key zu importieren ist der schnellste Weg zur Produktion, aber manche Teams können Key-Material überhaupt nicht an einen Dritten schicken. Der Grund kann eine interne Policy sein, ein Regulator, oder ein Hardware Security Module, dessen Keys physisch nicht exportiert werden können. Die TRON API hat einen zweiten Modus, gebaut genau für diese Einschränkung.
Der Flow hat drei Schritte. Rufen Sie POST /api/v2/tron/transactions/trc20/build auf, oder /api/v2/tron/transactions/build für reines TRX, mit denselben Feldern, die Sie für einen normalen Send nutzen würden.
Die API gibt die unsignierte Roh-Transaktion zurück. Signieren Sie dieses Payload, wo auch immer Ihre Keys leben: ein HSM, eine Air-Gapped-Maschine, ein Signing-Service hinter Ihrer eigenen Firewall. Reichen Sie dann das signierte Ergebnis über POST /api/v2/tron/transactions/broadcast ein, was es ans Netzwerk schiebt und den Transaktions-Hash zurückgibt.
# 1. Die unsignierte Transaktion bauen
curl -X POST https://app.chaingateway.io/api/v2/tron/transactions/trc20/build \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"contractaddress": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", "from": "TColdWallet", "to": "TRecipient", "amount": 1000}'
# 2. Lokal mit eigenem Tooling signieren, dann broadcasten
curl -X POST https://app.chaingateway.io/api/v2/tron/transactions/broadcast \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"signed_transaction": "<die signierte Transaktion als JSON-String>"}'
Zwei Dinge, bevor Sie diesen Modus wählen. Eine gebaute TRON-Transaktion läuft nach einem kurzen Fenster ab, der Sign-and-Broadcast-Schritt muss also zügig passieren statt über Nacht in einer Queue zu liegen. Und die operative Verantwortung verschiebt sich: Ihre Seite besitzt die Signing-Bibliothek und ihre Updates.
Was Sie gewinnen, ist, dass Chaingateway nie ein Secret sieht. Deposit-Monitoring bleibt in beiden Fällen unberührt, da das Beobachten einer Adresse keinen Key braucht. Viele Produktions-Setups mischen beide Modi, importierte Keys für Betriebs-Wallets mit geringem Wert, Self-Signing für den Treasury-Pfad.
Wie erkenne ich eingehende USDT-Zahlungen auf TRON?
Registrieren Sie einen Webhook für Ihre Deposit-Adresse und den USDT-Contract, und Chaingateway pusht jeden eingehenden Transfer an Ihren Server. Einen Explorer zu pollen verschwendet Requests und trifft das Timing trotzdem falsch. Ihr Backend erhält ein POST für Transaktionsstatus, Bestätigungen und Guthabenänderungen.
Setzen Sie ein persönliches Secret in Ihrem Konto, und jede Zustellung trägt einen X-Signature-Header – ein base64-kodiertes HMAC-SHA256 der txid des Payloads –, sodass Sie den Absender verifizieren können. Fehlgeschlagene Zustellungen landen in einer Failed-Notifications-Liste, und POST /api/v2/tron/webhooks/notifications/{id}/retry sendet jede erneut.
GET /api/v2/tron/webhooks/notifications gibt vergangene Benachrichtigungen zurück, praktisch, um Events nach einem schlechten Deploy erneut abzuspielen. Das Setup dauert wenige Minuten mit dem Webhook-Guide.
Staking: verbrannte Gebühren in eigene Ressourcen verwandeln
Sender mit hohem Volumen sollten TRX nicht auf ewig verbrennen. Frieren Sie TRX über POST /api/v2/tron/freeze ein, und das Netzwerk gewährt im Gegenzug Bandwidth oder Energy; routen Sie diese Ressourcen mit POST /api/v2/tron/delegate zu Ihrer Hot Wallet. Unfreeze und Undelegate kehren beide Schritte um, wenn Sie das Kapital zurückwollen.
Aktuelle Ressourcenpreise kommen von GET /api/v2/tron/chainparameters. Seit Proposal #104 liegt der Energy-Einheitenpreis bei 100 Sun, runter von 210, was den Break-even-Punkt zwischen Staken und Verbrennen verändert hat. Prüfen Sie den Live-Wert, bevor Sie einen Stake dimensionieren.
Die Rechnung begünstigt Staking mit wachsendem Volumen, weil verbranntes TRX weg ist, während gestaktes TRX nur geparkt ist. Als grober Wert Mitte 2026 generierte ein Stake in der Größenordnung von 5.000 TRX etwa die Energy für einen USDT-Transfer pro Tag.
Ein Geschäft mit 50 Transfers am Tag bräuchte einen Stake in den niedrigen Hunderttausenden TRX, um seine Energy vollständig aus dem Staken zu decken. Behandeln Sie das als Größenordnungen statt als Angebot: Ihr täglicher Ertrag hängt davon ab, wie viel TRX das gesamte Netzwerk gestakt hat, und dieses Verhältnis driftet. Der Fee-Calculator und der Chain-Parameters-Endpoint geben Ihnen die heutigen Eingaben für die Rechnung.
Delegation macht Staking operativ sauber. Halten Sie den Stake auf einer Treasury-Adresse, die nie Kundenverkehr berührt, und delegaten Sie ihre Energy dann an die Hot Wallets, die die tatsächlichen Sends erledigen.
Wird eine Wallet stillgelegt, undelegaten Sie und richten die Ressourcen auf ihren Nachfolger; das gestakte TRX selbst bewegt sich nie. Ein Vorbehalt für die Treasury-Planung: Nach dem Unfreeze bleibt TRX für eine Wartezeit von rund zwei Wochen gesperrt, bevor es wieder ausgebbar ist, ein Stake ist also keine Reserve mit sofortigem Zugriff. Dimensionieren Sie ihn nach dem Steady-State-Volumen und decken Sie Spitzen stattdessen mit gemieteter Energy ab.
Jedes Token auf TRON, auch Ihr eigenes
Chaingateway unterstützt die Standard-Token-Typen auf TRON. USDT, USDC und DAI funktionieren sofort mit automatischer Dezimalstellen-Handhabung. Für ein selbst gelauchtes Token übergeben Sie dessen Contract-Adresse, und die API behandelt es wie jedes andere TRC-20. Das Request-Schema wird über Chains hinweg geteilt, sodass der ERC-20-Aufruf auf Ethereum, BNB Smart Chain, Polygon oder Arbitrum exakt wie Ihr TRC-20-Aufruf aussieht, mit einem anderen Pfadsegment.
Warum Entwickler TRON für Zahlungen wählen
Gebühren sind auf TRON vorhersehbar: Ein USDT-Transfer verbraucht Energy und Bandwidth, und der Fee-Calculator sowie GET /api/v2/tron/chainparameters lassen Sie einen Transfer vor dem Senden bepreisen. Gesponserte Gebühren lassen eine Wallet ohne TRX Token senden. Und da USDT ein TRC-20-Token ist, senden dieselben Aufrufe, die USDT senden, auch jedes andere TRC-20-Token.
Gebaut für Zahlungs-Workloads
Typische Integrationen sehen so aus: ein Checkout-Flow, der USDT annimmt und die Bestellung nach Bestätigung gutschreibt; ein Börsen-Backend, das Tausende Deposit-Adressen beobachtet und Abhebungen aus einer Hot Wallet verarbeitet; Auszahlungssysteme, die Airdrops oder Vesting-Pläne fahren; Abo-Abrechnung, die jeden Monat in Stablecoins abrechnet; Remittance-Dienste, die Wert innerhalb von Minuten über Grenzen hinweg bewegen. Dieselbe API deckt jedes Muster ab. Was sich ändert, ist, welche Endpoints Sie kombinieren.
Zuerst den vollständigen Flow im Testnet testen
Jeder Endpoint auf dieser Seite akzeptiert den Header X-Network: testnet. Damit läuft der identische Request gegen das TRON-Testnet: gleiche Pfade, gleiche Payloads, gleiche Response-Formen. Test-TRX kommt kostenlos von öffentlichen Faucets, eine komplette Probe kostet also nichts – eine Deposit-Adresse erstellen, einen TRC-20-Transfer daran senden, den Webhook empfangen, die HMAC-Signatur verifizieren, in eine Hot Wallet fegen.
Proben Sie den Webhook-Pfad mindestens einmal Ende zu Ende. Die klassischen Integrationsfehler, eine Signaturprüfung gegen die falsche Payload-Kodierung oder eine Firewall, die die Zustellung still verwirft, treten auf Testnet exakt so auf wie in Produktion, wo sie echte Deposits statt Test-Token kosten. Live gehen bedeutet danach, einen Header zu löschen; der Quickstart zeigt den ganzen Zyklus.
Wenn Requests fehlschlagen
Zwei Fehlerklassen wollen entgegengesetzte Behandlung. Eine 4xx-Antwort bedeutet, dass der Request selbst falsch ist: ein fehlender oder abgelaufener Bearer-Token, eine fehlerhafte Adresse, ein Betrag, den die sendende Wallet nicht deckt. Loggen Sie ihn und beheben Sie die Ursache, aber wiederholen Sie ihn nicht unverändert, weil identischer Input identische Ablehnung produziert. Eine 5xx-Antwort oder ein Netzwerk-Timeout sagt nichts über Ihren Input aus; wiederholen Sie diese mit exponentiellem Backoff und einer Obergrenze.
Der Randfall, für den es sich zu konstruieren lohnt, ist der Timeout nach einem Send. Ihr HTTP-Client hat aufgegeben, doch die Transaktion könnte trotzdem broadcastet worden sein. Denselben Transfer reflexartig erneut zu feuern, ist, wie doppelte Auszahlungen passieren.
Prüfen Sie zuerst, was tatsächlich rausging: GET /api/v2/tron/transactions listet die über Ihr Konto erstellten Transfers. Senden Sie nur erneut, wenn der erste Versuch nachweislich fehlschlug. Für Fee-bezogene Fehlschläge gibt es ein noch günstigeres Muster: Prüfen Sie GET /api/v2/tron/chainparameters und die Ressourcen der Wallet vor dem Senden, und verwandeln Sie so einen Laufzeitfehler in einen Preflight-Check.
Von der Anmeldung zur Produktion in drei Schritten
Holen Sie sich Ihren API-Key. Registrieren Sie sich, und der Key ist sofort verfügbar. Der Test läuft 7 Tage und braucht zum Start kein KYC.
Stellen Sie Ihren ersten Request. Der Quickstart führt durch die erste Adresse und den ersten Transfer.
Richten Sie Webhooks ein und gehen Sie live. Richten Sie eine URL auf Ihr Backend und abonnieren Sie Deposit-Events, wie im Webhook-Guide gezeigt, entfernen Sie dann den X-Network: testnet-Header; der Code bleibt gleich. Pläne und Limits stehen auf der Preisseite.
Was auf welcher Chain funktioniert
TRON ist die tiefste Integration auf der Plattform – die einzige Chain hier mit TRC-10 neben TRC-20 und nativem Staking. Die Tabelle unten ordnet es neben den anderen sechs von der API abgedeckten Chains ein.
| Chain | Adressen | Token-Transfers | Deposit-Webhooks |
|---|---|---|---|
| Bitcoin | POST /api/v2/bitcoin/wallets/{wallet}/addresses | — (kein Token-Standard) | GET /api/v2/bitcoin/webhooks/notifications |
| Ethereum | POST /api/v2/ethereum/addresses/import | ERC-20: POST /api/v2/ethereum/transactions/erc20 | GET /api/v2/ethereum/webhooks/notifications |
| TRON | POST /api/v2/tron/addresses/import | TRC-20 und TRC-10: POST /api/v2/tron/transactions/trc20 und .../trc10 | GET /api/v2/tron/webhooks/notifications |
| Solana | POST /api/v2/solana/addresses | SPL: POST /api/v2/solana/transactions/SPL | — |
| BNB Smart Chain | POST /api/v2/bsc/addresses/import | BEP-20: POST /api/v2/bsc/transactions/bep20 | GET /api/v2/bsc/webhooks/notifications |
| Polygon | POST /api/v2/polygon/addresses/import | ERC-20: POST /api/v2/polygon/transactions/erc20 | GET /api/v2/polygon/webhooks/notifications |
| Arbitrum | POST /api/v2/arbitrum/addresses/import | ERC-20: POST /api/v2/arbitrum/transactions/erc20 | GET /api/v2/arbitrum/webhooks/notifications |
Zwei Fußnoten, um die Tabelle richtig zu lesen. Erstens, über die obigen Routen hinaus: Die eigene Referenz dieser Seite dokumentiert Staking (POST /api/v2/tron/freeze und /delegate), Chain-Parameter und ein Self-Signing-Paar – /transactions/trc20/build, um eine Transaktion zu konstruieren, und /transactions/broadcast, um eine lokal signierte einzureichen. Besteht Ihr Compliance-Team darauf, dass Private Keys Ihre Server nie verlassen, ist dieses Build-and-Broadcast-Muster Ihr Weg.
Zweitens: Ein Strich bedeutet, dass die aktuelle Referenz für diese Zelle keine v2-Route dokumentiert, nicht dass das Netzwerk zweite Wahl ist. Bitcoin hat keinen Token-Standard, daher die leere Token-Zelle – natives BTC läuft stattdessen über sein eigenes Wallet-Modell: eine passwortverschlüsselte Wallet mit POST /api/v2/bitcoin/wallets erstellen, Deposit-Adressen darunter ableiten und mit POST /api/v2/bitcoin/transactions senden. Solanas Referenz deckt Adresserstellung, SOL- und SPL-Transfers sowie Guthaben- und Block-Abfragen ab, aber noch keine Webhooks. Für alles, was hier nicht aufgeführt ist, hat die API-Referenz den aktuellen Stand.
Quellen und weiterführende Literatur
Diese Primärquellen dokumentieren die Standards und das Chain-Verhalten, die auf dieser Seite beschrieben sind:
- Resource Model: TRON-Developer-Hub, behandelt Bandwidth und Energy.
- TRC-20 protocol interface: TRON-Developer-Hub, die Token-Schnittstelle hinter USDT-TRC20.
- Transactions: TRON-Developer-Hub, behandelt den Lebenszyklus einer Transaktion.
FAQ: TRON API
Bereit, TRON zu integrieren?
Erstellen Sie ein Konto unter app.chaingateway.io/register, holen Sie sich den API-Key und senden Sie Ihren ersten Testnet-TRC-20-Transfer. Die vollständige Endpoint-Referenz steht in den Docs, und Pläne und Rate Limits haben ihre eigene Seite.
Geprüft von Maurice Sobiera So entstehen diese Seiten