Blockchain-API-Anwendungsfälle: sechs Beispiele
Sechs Anwendungsfälle einer Blockchain-API mit den genutzten Chaingateway-Endpunkten: Zahlungen, Auszahlungen, Wallets, Monitoring, Abfragen, NFT-Prüfung.
Geprüft von Maurice Sobiera
Eine Blockchain-API ist ein Webdienst, mit dem eine Anwendung über HTTPS Adressen erstellen, Guthaben lesen, Transaktionen senden und Benachrichtigungen empfangen kann, ohne eigene Blockchain-Nodes zu betreiben. Sie kapselt die Low-Level-Schnittstelle des Nodes, meist JSON-RPC, in einen kleineren Satz von Aufrufen. Die folgenden Anwendungsfälle zeigen, welche Aufrufe jeder braucht.
Wofür wird eine Blockchain-API genutzt?
Die gängigen Einsatzzwecke lassen sich auf sechs Aufgaben zurückführen. Jede entspricht einigen Endpunkten der Chaingateway-REST-API, und dasselbe Muster gibt es auf jedem unterstützten Netzwerk, sofern nichts anderes vermerkt ist.
| Anwendungsfall | Was die Anwendung tut | Wichtigste Endpunkte (am Beispiel Ethereum) |
|---|---|---|
| Krypto-Zahlungen annehmen | Pro Bestellung eine Einzahlungsadresse erstellen und auf die Zahlung warten | POST /addresses, POST /webhooks, GET /balances/{address} |
| Token auszahlen oder per Airdrop verteilen | Native Coins oder Token an viele Adressen senden | POST /transactions, POST /transactions/erc20 |
| Ein Wallet-Backend betreiben | Adressen erstellen, importieren und exportieren | POST /addresses, POST /addresses/import, GET /addresses/export/{address} |
| Adressen überwachen | Auf eingehende und ausgehende Überweisungen reagieren | POST /webhooks, GET /webhooks/notifications |
| Chain-Daten abfragen | Blöcke, Transaktionen und Belege lesen | GET /blocks/{block_number}, GET /transactions/{txid} |
| NFTs prüfen | Eigentümer und Metadaten-URI eines Tokens lesen | GET /nfts/{contract_address}/owner/{token_id} |
Alle Pfade beginnen mit /api/v2/{blockchain}, zum Beispiel /api/v2/ethereum/addresses. Die vollständige Liste steht in der API-Referenz.
Wie nehmen Sie Krypto-Zahlungen per API an?
Erstellen Sie für jede Bestellung eine Einzahlungsadresse, registrieren Sie dafür einen Webhook, und behandeln Sie den Webhook als Signal, dass eine Zahlung eingetroffen ist. Der Adress-Aufruf liefert eine neue Adresse. Der Webhook-Aufruf nimmt die Adresse (to), eine url und einen type wie ETH, ERC20 oder ERC721 entgegen, dazu eine optionale reference mit bis zu 255 Zeichen, die Sie als Ihre Bestell-ID nutzen können.
# 1. Create a password-protected deposit addresscurl -X POST https://app.chaingateway.io/api/v2/ethereum/addresses \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{"password": "a-long-random-password"}'
# 2. Watch it for incoming ERC-20 transferscurl -X POST https://app.chaingateway.io/api/v2/ethereum/webhooks \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "to": "0xDepositAddressFromStep1", "contractaddress": "0xTokenContractAddress", "type": "ERC20", "url": "https://shop.example.com/hooks/chaingateway", "reference": "order-10231" }'Erscheint eine passende Überweisung, sendet Chaingateway eine Benachrichtigung an Ihre URL. Prüfen Sie deren X-Signature-Header, und bestätigen Sie den Betrag gegen die Chain, bevor Sie Ware freigeben. Webhooks werden nicht automatisch wiederholt: Fehlgeschlagene Benachrichtigungen werden unter /webhooks/notifications/failed aufgelistet und können erneut gesendet werden. Solana hat keine Webhooks, fragen Sie dort stattdessen den Guthaben-Endpunkt per Polling ab. Unser Leitfaden zu Zahlungs-Webhooks behandelt den vollständigen Ablauf.
Wie senden Sie Auszahlungen oder Airdrops?
Rufen Sie den Transaktions-Endpunkt aus einem Skript einmal pro Empfänger auf. Für Token nutzen Sie POST /api/v2/ethereum/transactions/erc20 mit Absender, Contract-Adresse, Empfänger und Betrag.
Jede Überweisung braucht Gas in der nativen Coin des Netzwerks auf der sendenden Adresse. Prüfen Sie GET /gasprice vor einem großen Batch, und senden Sie die Überweisungen pro sendender Adresse nacheinander, damit sich Nonces nicht überschneiden. NFT-Überweisungen nutzen den Endpunkt erc721, beschrieben in NFTs per API übertragen.
Kann eine API ein Wallet-Backend betreiben?
Ja, mit Einschränkungen. Die Adress-Endpunkte erstellen Adressen, und ein Parameter password speichert den privaten Schlüssel verschlüsselt auf dem Server, sodass Sie mit dem Passwort statt mit dem Schlüssel senden können. Sie können eine bestehende Adresse importieren und später einen privaten Schlüssel exportieren. Der Leitfaden zur Wallet-Verwaltung listet die Abwägungen auf, und unsere Sicherheitstipps erklären, warum langfristige Guthaben in die Cold Storage gehören.
Guthaben stammen von GET /balances/{address} für die native Coin und von GET /balances/{address}/erc20 für Token. Der Endpunkt für die Transaktionsliste zeigt nur Transaktionen, die über die Chaingateway-API erstellt wurden. Er indiziert nicht jede Transaktion einer Adresse, nutzen Sie also Webhooks, wenn Sie auch eingehende Überweisungen brauchen.
Wie überwachen Sie Adressen und fragen Chain-Daten ab?
Nutzen Sie Webhooks für Ereignisse und die Abfrage-Endpunkte für den Verlauf. Webhooks decken Adressen und Contracts ab, die Sie registrieren. Für alles andere lesen Sie Blöcke nach Nummer, eine Transaktion nach Hash oder eine dekodierte Transaktion. Bitcoin hat eigene wallet-basierte Endpunkte unter /api/v2/bitcoin. Wenn Sie statt dieser Aufrufe rohen Node-Zugriff brauchen, sind die Methoden in der Ethereum-JSON-RPC-Referenz und der Bitcoin-RPC-Referenz dokumentiert.
Welche Netzwerke unterstützen welchen Anwendungsfall?
Die Unterstützung unterscheidet sich je nach Netzwerk, wie die OpenAPI-Datei zeigt. Prüfen Sie diese Tabelle, bevor Sie um eine Funktion herum planen.
| Netzwerk | Webhooks | Token-Überweisungen | NFT-Eigentümer- und URI-Abfrage | Wallet-Modell |
|---|---|---|---|---|
| Ethereum, Polygon, Arbitrum | Ja | ERC-20 und ERC-721 | Ja | Einzelne Adressen |
| BNB Smart Chain | Ja | BEP-20 und BEP-721 | Ja | Einzelne Adressen |
| TRON | Ja | TRC-20 und TRC-721 | Kein Abfrage-Endpunkt | Einzelne Adressen |
| Solana | Nein | SPL | Ja | Einzelne Adressen |
| Bitcoin | Ja | Nur native Coin | Nicht zutreffend | Wallets, die Adressen enthalten |
Ein Zahlungsablauf, der von Webhooks abhängt, braucht auf Solana daher einen Polling-Fallback. Ein Ablauf, der von NFT-Eigentumsprüfungen abhängt, braucht auf TRON eine andere Datenquelle.
Wie probieren Sie einen Anwendungsfall ohne echte Gelder aus?
Führen Sie ihn zuerst auf einem Testnetzwerk aus. Fügen Sie jeder Anfrage den Header X-Network: testnet hinzu, dann arbeitet derselbe Endpunkt gegen das Testnetzwerk statt gegen das Mainnet. Lassen Sie den Header weg oder setzen Sie ihn auf mainnet, um zurückzuwechseln. So können Sie Adresserstellung, eine Überweisung und einen Webhook-Roundtrip einschließlich Signaturprüfung testen, bevor echter Wert im Spiel ist.
Chaingateway hat eine 7-tägige kostenlose Testphase ohne Karte, und zum Start brauchen Sie keine Identitätsprüfung. Die Schritte sind kurz:
- Erstellen Sie ein Konto und kopieren Sie Ihr API-Token aus dem Dashboard.
- Erstellen Sie eine Testadresse und laden Sie sie an einem öffentlichen Faucet des gewählten Testnetzwerks auf.
- Registrieren Sie einen Webhook, der auf eine öffentliche URL Ihres Empfängers zeigt.
- Senden Sie eine Testüberweisung und prüfen Sie, dass die Benachrichtigung eintrifft und ihre Signatur verifiziert wird.
Unser Quickstart-Leitfaden führt mit Codebeispielen durch dieselbe Abfolge.
Welche Anwendungsfälle passen schlecht?
Eine solche API passt schlecht zu Aufgaben, die den vollständigen Chain-Verlauf beliebiger Adressen brauchen, etwa Analysen, Steuerberichte oder Kreditentscheidungen. Diese Aufgaben brauchen einen Indexer, der jede Transaktion speichert, keinen Dienst, der Transaktionen sendet und Sie über die von Ihnen registrierten Adressen benachrichtigt. Bauen oder kaufen Sie diesen Teil separat, und nutzen Sie die API für die Transaktions- und Benachrichtigungsseite.
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.