Zum Inhalt springen

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.

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.

AufgabeTypischer EndpunktChains
Wallet-Adresse erstellenPOST /api/v2/{chain}/addressesEthereum, BSC, Polygon, Arbitrum, TRON, Solana
Bitcoin-Wallet und zugehörige Adressen erstellenPOST /api/v2/bitcoin/walletsBitcoin
Native Coins sendenPOST /api/v2/{chain}/transactionsalle sieben
Token sendenPOST /api/v2/{chain}/transactions/erc20, /bep20, /trc20, /SPLalle außer Bitcoin
Guthaben und Blöcke lesenGET /api/v2/{chain}/balances/{address}alle sieben
Über Zahlungen benachrichtigt werdenPOST /api/v2/{chain}/webhooksalle außer Solana
Marktpreis lesenGET /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.

Integrationsablauf in vier Schritten: API-Key erstellen, Adresse erstellen, Transaktionen senden oder lesen, Webhooks empfangen 1. API-Key erstellen Dashboard, API-Tokens 2. Adresse erstellen POST /api/v2/{chain}/addresses 3. Transaktionen senden und lesen POST und GET /api/v2/{chain}/transactions 4. Webhooks empfangen POST /api/v2/{chain}/webhooks, Ihr Serverantwortet 200
Die übliche Reihenfolge einer Integration. Schritt 3 und 4 können parallel laufen.

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.

Terminal-Fenster
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.

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.

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.

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."] }
}

Wählen Sie die Seite, die zu Ihrer aktuellen Aufgabe passt:

Die in dieser Dokumentation verwendeten HTTP- und Token-Konventionen sind in öffentlichen Standards definiert: