Blockchain-API: Was sie leistet und warum man sie nutzt
Eine Blockchain-API lässt Ihre Software Chains lesen und Transaktionen per HTTPS senden, ohne Nodes zu betreiben. Was sie abdeckt und wo sie endet.
Geprüft von Maurice Sobiera
Eine Blockchain-API ist eine Web-Schnittstelle, über die Ihre Software Blockchain-Daten liest und Transaktionen sendet, ohne einen Node zu betreiben. Sie senden HTTPS-Anfragen und erhalten JSON. Das Sprechen des nativen Protokolls jeder Chain entfällt. Die API von Chaingateway deckt Bitcoin, Ethereum, Tron, BNB Smart Chain, Polygon, Arbitrum und Solana mit einem einzigen Authentifizierungsverfahren ab.
Warum brauchen Blockchains eine API-Schicht?
Jede Chain hat eine eigene native Schnittstelle, und keine davon ist für Anwendungsentwickler gebaut. Ein Node stellt Methoden auf niedriger Ebene bereit, dazu rohe Kodierungen und ein eigenes Adressformat. Die Tabelle zeigt, womit Entwickler ohne API-Schicht anfangen.
| Chain-Familie | Native Schnittstelle | Was Sie selbst übernehmen |
|---|---|---|
| Ethereum, BNB Smart Chain, Polygon, Arbitrum | JSON-RPC auf eigenem Node oder einem gehosteten Endpunkt | Hex-kodierte Mengen, ABI-Dekodierung von Token-Transfers, Gas-Einstellungen |
| Bitcoin | Bitcoin-Core-RPC | UTXO-Verwaltung, Gebührenschätzung, Wallet-Dateien |
| Tron | java-tron-Node-Schnittstellen, HTTP- und Event-Plugins | Energy- und Bandwidth-Ressourcen, protobuf-basierte Transaktionen |
Eine API-Schicht legt darüber einen einheitlichen Anfragestil. Eine Adresse erstellen Sie auf Ethereum, BNB Smart Chain, Polygon, Arbitrum, Tron und Solana mit POST /api/v2/<chain>/addresses. Bitcoin arbeitet mit Wallets, die Sie mit POST /api/v2/bitcoin/wallets anlegen. Token-Transfers folgen auf jeder Chain mit Token demselben Muster.
Die Unterschiede, die bleiben, sind echte Unterschiede zwischen den Chains, etwa die Ressourcen von Tron oder die Gebühren von Bitcoin. Der Artikel Blockchain-API vs. Node vergleicht beide Wege ausführlicher.
Was können Sie mit einer Blockchain-API tun?
Sie können Adressen anlegen, native Coins und Token senden, Blöcke und Transaktionen lesen und Benachrichtigungen empfangen. In der API-Referenz von Chaingateway sind das die wichtigsten Gruppen:
- Adressen: anlegen (mit oder ohne Passwort, das den Schlüssel verschlüsselt), importieren und auflisten
- Transaktionen: native Währung senden, ERC20-, TRC20- und BEP20-Token sowie ERC721-NFTs senden und Transaktionen lesen
- Netzwerkdaten: die Nummer des neuesten Blocks und auf EVM-Chains den Gaspreis
- Webhooks: eine Adresse und eine URL registrieren und dann einen POST erhalten, sobald eine passende Transaktion stattfindet
- Nur Tron: Einfrieren und Delegieren von Ressourcen für Energy und Bandwidth
Nicht jede Chain hat jede Gruppe. Solana hat zum Beispiel keine Webhooks. Die OpenAPI-Datei listet genau auf, welche Endpunkte es für welche Chain gibt.
Wie funktioniert die Authentifizierung?
Jede Anfrage trägt ein Bearer-Token im Header Authorization, wie in RFC 6750 definiert. Mainnet ist der Standard. Für ein Testnetz fügen Sie den Header X-Network: testnet hinzu:
curl https://app.chaingateway.io/api/v2/ethereum/blocks/number \ -H "Authorization: Bearer $CHAINGATEWAY_TOKEN" \ -H "X-Network: testnet"Derselbe Aufruf ohne den zweiten Header liefert den neuesten Mainnet-Block. Testnetze sind unter anderem Sepolia für Ethereum, Nile für Tron, Amoy für Polygon und Devnet für Solana. Die vollständige Liste steht auf der Seite unterstützte Netzwerke. Bewahren Sie das Token auf Ihrem Server auf. Wer es hat, kann Ihr Konto nutzen.
Welche Anwendungsfälle passen zu einer Blockchain-API?
Zahlungsannahme, Überwachung von Einzahlungen und Token-Verteilung sind die häufigsten. Ein Shop gibt jeder Bestellung eine eigene Adresse und registriert dafür einen Webhook. Eine Börse oder ein Wallet-Dienst macht dasselbe für Einzahlungen von Nutzern. Ein Projekt, das Token an viele Empfänger auszahlt, sendet pro Empfänger eine Transferanfrage. Der Artikel zur Lieferkette zeigt einen Zahlungsablauf mit einer Rechnungsreferenz.
Frühere Fassungen dieses Artikels führten auch dezentrale Anwendungen, Identitätsprüfung und das Erstellen von Smart Contracts als API-Funktionen auf. Die API deployt keine Smart Contracts, und Identitätsprüfung gehört nicht dazu. Die Logik einer dApp liegt in Contracts, die Sie mit anderen Werkzeugen deployen. Die API ist der Weg, auf dem Ihr Server mit der Chain um sie herum spricht.
Wie sieht eine Integration aus?
Eine Zahlungsintegration hat fünf Schritte. Jeder davon ist eine einzelne Anfrage:
- Erstellen Sie eine Adresse für die Bestellung oder den Nutzer:
POST /api/v2/ethereum/addressesmit einempassword. Die Antwort enthält die neue Adresse. - Registrieren Sie für diese Adresse mit
POST /api/v2/ethereum/webhookseinen Webhook. Ihre Empfänger-URL steht inurl. - Zeigen Sie dem Zahlenden die Adresse.
- Ihr Empfänger erhält einen POST mit Transaktions-ID, Absender, Empfänger, Blocknummer und Typ. Er antwortet mit einem Erfolgsstatus.
- Leiten Sie Gelder mit
POST /api/v2/ethereum/transactionsweiter oder mit.../transactions/erc20für einen Token.
Testen Sie alle fünf Schritte zuerst mit X-Network: testnet. Testnet-Coins haben keinen Wert, ein Fehler kostet also nichts.
Was kann eine Blockchain-API nicht?
Sie ändert nicht, wie die Chain arbeitet. Diese Grenzen sollten Sie einplanen:
- Eine Transaktion kann trotzdem scheitern, etwa wegen fehlendem Gas. Die Bestätigungszeit legt die Chain fest, nicht die API.
- Webhooks werden nicht automatisch wiederholt. Fehlgeschlagene Benachrichtigungen sind aufgelistet, und Sie fordern das erneute Senden an.
- Schlüssel brauchen Sorgfalt. Eine Wallet ohne Passwort gibt ihren privaten Schlüssel in der Antwort zurück. Mit Passwort wird der Schlüssel auf der Seite von Chaingateway verschlüsselt gespeichert. Chaingateway speichert das Passwort nicht. Ein verlorenes Passwort bedeutet deshalb, dass sich die Wallet nicht wiederherstellen lässt.
- Ein Anbieter bleibt eine Abhängigkeit. Führen Sie eigene Aufzeichnungen zu jeder Transaktions-ID, die Sie erzeugen.
Möchten Sie das selbst umsetzen? API-Key erhalten — 7 Tage kostenlos testen, keine Karte nötig — oder werfen Sie einen Blick auf Blockchain-API für die vollständige Endpoint-Referenz.