Chaingateway Entwicklerportal und API-Doku
Das Chaingateway-Entwicklerportal dokumentiert eine REST-API, mit der Sie Adressen erstellen, Transaktionen senden, Guthaben lesen und Webhooks empfangen, und zwar auf Ethereum, TRON, BNB Smart Chain, Bitcoin, Polygon, Arbitrum und Solana. Beginnen Sie mit dem Schnellstart: Sie erstellen einen API-Key, senden eine Anfrage und wechseln mit einem einzigen Header zwischen Mainnet und Testnet.
📝 Erste Schritte
Lernen Sie die Grundlagen von Chaingateway kennen und erfahren Sie, wie Sie loslegen können
💻 API-Dokumentation
Durchsuchen Sie die Dokumentation unserer einfach zu nutzenden Blockchain-Gateway-API
🔔 Webhooks
Erfahren Sie, wie unser Instant-Payment-Notification-System Sie über Blockchain-Ereignisse benachrichtigen kann
🎓 Tutorials
Nützliche Tutorials, wie Sie die Chaingateway-API anhand von Beispiel-Use-Cases einsetzen
Was kann ich mit der Chaingateway-API tun?
Abschnitt betitelt „Was kann ich mit der Chaingateway-API tun?“Sie können Wallets verwalten, native Coins und Token senden, Blockchain-Daten lesen und Zahlungsbenachrichtigungen abonnieren, alles über eine REST-Schnittstelle. Die OpenAPI-Datei listet mehr als 200 Operationen auf. Sie sind pro Chain gruppiert, und das Muster wiederholt sich auf allen EVM-Chains.
| Aufgabe | Typischer Endpunkt | Chains |
|---|---|---|
| Wallet-Adresse erstellen | POST /api/v2/{chain}/addresses | Ethereum, BSC, Polygon, Arbitrum, TRON, Solana |
| Bitcoin-Wallet und zugehörige Adressen erstellen | POST /api/v2/bitcoin/wallets | Bitcoin |
| Native Coins senden | POST /api/v2/{chain}/transactions | alle sieben |
| Token senden | POST /api/v2/{chain}/transactions/erc20, /bep20, /trc20, /SPL | alle außer Bitcoin |
| Guthaben und Blöcke lesen | GET /api/v2/{chain}/balances/{address} | alle sieben |
| Über Zahlungen benachrichtigt werden | POST /api/v2/{chain}/webhooks | alle außer Solana |
| Marktpreis lesen | GET /api/v2/market/price/{crypto}/{fiat} | chainunabhängig |
Solana hat keine Webhook-Endpunkte, daher müssen Einzahlungen auf Solana über das Lesen von Guthaben oder Transaktionen erkannt werden. Wallets sind non-custodial: Entweder wählen Sie ein Passwort, das den gespeicherten Schlüssel schützt, oder Sie erhalten den Private Key in der Antwort und bewahren ihn selbst auf. Wallet-Verwaltung erklärt beide Modi.
Wie sende ich meine erste Anfrage?
Abschnitt betitelt „Wie sende ich meine erste Anfrage?“Erstellen Sie im Dashboard einen API-Key und senden Sie ihn als Bearer-Token im Header Authorization. Ein neues Konto startet mit einer 7-tägigen kostenlosen Testphase, zum Einstieg sind weder Karte noch Identitätsprüfung nötig. Die folgende Anfrage liest die aktuelle Ethereum-Blocknummer.
curl --request GET \ --url https://app.chaingateway.io/api/v2/ethereum/blocks/number \ --header 'Accept: application/json' \ --header 'Authorization: Bearer YOUR_API_TOKEN'Eine Anfrage ohne gültigen Token liefert HTTP 401 mit dem Body {"message":"Unauthenticated."}. Um denselben Aufruf im Testnetz auszuführen, fügen Sie den Header X-Network: testnet hinzu. Lassen Sie den Header weg oder setzen Sie ihn auf mainnet, um das Hauptnetz zu nutzen. Der Schnellstart führt durch Kontoeinrichtung, Header und eine POST-Anfrage in vier Sprachen.
Welche Netzwerke unterstützt die API?
Abschnitt betitelt „Welche Netzwerke unterstützt die API?“Sieben Blockchains stehen zur Verfügung, jeweils mit Mainnet und Testnet. Die Testnets sind Sepolia für Ethereum, Nile für TRON, das BNB-Smart-Chain-Testnet, Bitcoin testnet3, Amoy für Polygon, Arbitrum Sepolia und Solana devnet. Unterstützte Netzwerke listet jedes Netzwerk mit dem passenden X-Network-Wert auf und erklärt die beiden Header-Werte.
Wo finde ich die vollständige API-Referenz?
Abschnitt betitelt „Wo finde ich die vollständige API-Referenz?“Die interaktive Referenz finden Sie unter chaingateway.io/docs. Sie wird aus derselben Datei openapi.yaml erzeugt, die Sie in Postman, Insomnia oder einen Codegenerator importieren können. Jede Operation nennt ihre Parameter, die Validierungsregeln für Adressen und die Beispielantworten, auch die Fehler-Bodys.
Alle Antworten teilen sich einen JSON-Umschlag mit den Feldern status, ok und message. Erfolgreiche Aufrufe fügen data hinzu, eine fehlgeschlagene Validierung fügt ein Objekt errors hinzu. Die FAQ zeigt Beispiele für beides.
Wie sieht eine Antwort aus?
Abschnitt betitelt „Wie sieht eine Antwort aus?“Jeder Endpunkt antwortet mit JSON. Ein erfolgreicher Aufruf liefert ok: true zusammen mit dem HTTP-Status und einem Feld data. Das nächste Beispiel ist die Antwort von GET /api/v2/ethereum/gasprice.
{ "ok": true, "status": 200, "message": "Successfully parsed", "data": { "gasPrice": "12.28" }}Eine fehlgeschlagene Validierung liefert Status 422 und nennt jedes abgelehnte Feld. Derselbe Umschlag transportiert Blockchain-Fehler, zum Beispiel ein zu geringes Guthaben für Gas. Ein falsches Wallet-Passwort liefert 401 mit der Meldung Wrong password provided. Schreiben Sie Ihren Client so, dass er zuerst ok prüft und bei false message und errors protokolliert.
{ "status": 422, "ok": false, "message": "Data validation failed", "errors": { "password": ["The password field is required."] }}Welche Anleitung sollte ich als Nächstes lesen?
Abschnitt betitelt „Welche Anleitung sollte ich als Nächstes lesen?“Wählen Sie die Seite, die zu Ihrer aktuellen Aufgabe passt:
- Um Schlüssel sicher zu speichern, lesen Sie Wallet-Verwaltung.
- Um eingehende Zahlungen zu erkennen, lesen Sie Webhooks und danach Webhook-Sicherheit.
- Um Coins zu senden, folgen Sie Transaktionen erstellen und Token-Transaktionen erstellen.
- Um TRON-Gebühren ohne TRX zu zahlen, lesen Sie TRC20-Gebühren sponsern.
Quellen
Abschnitt betitelt „Quellen“Die in dieser Dokumentation verwendeten HTTP- und Token-Konventionen sind in öffentlichen Standards definiert:
- RFC 9110, HTTP Semantics für Methoden, Statuscodes und Header.
- RFC 6750, Bearer Token Usage für den Header
Authorization: Bearer. - RFC 8259, The JSON Data Interchange Format für Request- und Response-Bodys.
- Ethereum-Entwicklerdokumentation und TRON-Entwicklerdokumentation für die Chains hinter den Endpunkten.