Wie verwende ich die KuCoin-API für Trading-Bots? (Entwicklertools)

Authentifizierungsmechanismus

1. Die KuCoin-API erfordert die Generierung einer HMAC-SHA256-Signatur für alle privaten Endpunkte. Die Signatur wird aus einer Verkettung von Zeitstempel, HTTP-Methode, Endpunktpfad und optionalem Anforderungstext abgeleitet.

2. Jede Anfrage muss drei Header enthalten: KC-API-KEY , KC-API-TIMESTAMP und KC-API-SIGN . Der Zeitstempel muss innerhalb von 5 Sekunden der Serverzeit von KuCoin liegen.

3. Das API-Schlüsselpaar muss über die KuCoin-Benutzeroberfläche unter API Management generiert werden. Berechtigungen sollten auf nur notwendige Bereiche wie „Handel“, „Konto“ oder „Auszahlen“ beschränkt werden.

4. Geheime Schlüssel werden niemals über das Kabel übertragen. Sie bleiben lokal in der Bot-Umgebung und werden ausschließlich zum Signieren ausgehender Anfragen verwendet.

5. IP-Whitelisting wird standardmäßig für neu erstellte API-Schlüssel erzwungen. Entwickler müssen vertrauenswürdige IPs im Voraus registrieren, um nicht autorisierte 401-Antworten zu vermeiden.

Auftragslebenszyklusmanagement

1. Beim Platzieren einer Order wird der Endpunkt POST /api/v1/orders mit Parametern wie Symbol, Seite (Kauf/Verkauf), Typ (Limit/Markt/Stopp) und Größe oder Preis verwendet.

2. Marktaufträge erfordern nur Größe und Seite; Limitaufträge erfordern sowohl Preis als auch Größe. Stop-Orders führen zusätzliche Felder wie stopPrice und stop ein.

3. Aktive Bestellungen können über GET /api/v1/orders?status=active abgefragt werden und geben paginierte Ergebnisse mit Bestell-IDs, Status, gefüllter Größe und verbleibender Größe zurück.

4. Zum Stornieren einer einzelnen Bestellung wird DELETE /api/v1/orders/{order-id} verwendet, während die Massenstornierung mit DELETE /api/v1/orders?symbol=BTC-USDT auf mehrere IDs abzielt.

5. Der Status der Auftragsausführung wird über WebSocket-Feeds oder durch Abfragen des GET /api/v1/fills -Endpunkts verfolgt, der den Handelsverlauf einschließlich Gebührenbeträgen und Zeitstempeln zurückgibt.

Marktdatenintegration

1. Öffentliche Tickerdaten werden über GET /api/v1/market/orderbook/level2_20?symbol=BTC-USDT abgerufen und liefern die Top-20-Geld-/Briefniveaus mit Preis, Größe und Sequenznummer.

2. Echtzeitaktualisierungen werden über den WebSocket v2-Kanal /market/ticker:{symbol} von KuCoin unterstützt, bei dem Clients JSON-Nachrichten verwenden, die Topic- und PrivateChannel-Flags enthalten.

3. Historische Kline-Daten werden mit GET /api/v1/market/candles?symbol=ETH-USDT&interval=1min&startAt=1698777600&endAt=1698781200 abgerufen und unterstützen Intervalle von 1 Minute bis 1 Tag.

4. Die Liste der Symbole und Einzelheiten zu den Handelspaaren sind unter GET /api/v2/symbols verfügbar, einschließlich der Einschränkungen „baseCurrency“, „quoteCurrency“, „priceIncrement“ und „minSize“.

5. Tiefen-Snapshots enthalten Sequenznummern, die eine Delta-Synchronisierung ermöglichen. Kunden müssen die Sequenzkontinuität überprüfen, um verpasste Aktualisierungen oder veraltete Orderbuchstände zu vermeiden.

Ratenbegrenzung und Fehlerbehandlung

1. KuCoin erzwingt strenge Ratenbegrenzungen: 100 Anfragen pro Sekunde für öffentliche Endpunkte und 20 pro Sekunde für private Endpunkte auf Standard-API-Schlüsseln.

2. Das Überschreiten der Grenzwerte löst HTTP 429-Antworten mit Retry-After-Headern aus, die die obligatorische Backoff-Dauer in Millisekunden angeben.

3. Zu den häufigsten Fehlercodes gehören 400 (ungültiger Parameter), 401 (Authentifizierungsfehler), 403 (unzureichende Berechtigungen) und 404 (Symbol nicht gefunden).

4. Alle Fehlerantworten enthalten standardisierte JSON-Körper mit Code, Nachrichten und manchmal Vorschlagsfeldern – z. B. {'code':'400100','msg':'Invalid symbol'} .

5. Für die Auftragserteilung sind Idempotenzschlüssel erforderlich, um doppelte Übermittlungen zu verhindern. Es müssen eindeutige UUIDs sein, die im KC-API-REQ-ID- Header gesendet werden.

Häufig gestellte Fragen

F: Kann ich denselben API-Schlüssel für mehrere Bot-Instanzen verwenden? A: Ja, aber gleichzeitige Anfragen, die die Ratengrenzen überschreiten, führen zu einer Drosselung. Geteilte Schlüssel erhöhen auch das Sicherheitsrisiko, wenn sie kompromittiert werden.

F: Warum gibt meine signierte Anfrage „Ungültige Signatur“ zurück, auch wenn der Zeitstempel und das Geheimnis korrekt sind? A: Meistens aufgrund einer falschen Kanonisierung von Zeichenfolgen – fehlende Zeilenumbrüche zwischen Komponenten, falsche UTF-8-Kodierung des Anforderungstexts oder nachgestellte Leerzeichen in der Prehash-Zeichenfolge.

F: Unterstützen WebSocket-Verbindungen die erneute Verbindung mit Statusresynchronisierung? A: Ja, KuCoin stellt in jeder Nachricht Sequenznummern bereit. Bei der Wiederherstellung der Verbindung sollten Clients einen neuen Snapshot anfordern und alle Nachrichten verwerfen, deren Sequenznummer niedriger ist als die zuletzt verarbeitete.

F: Wird der Margin- oder Futures-Handel über dieselbe REST-API unterstützt? A: Nein. Margin- und Futures-Operationen erfordern separate API-Basen: https://api.kucoin.com/api/v1/margin und https://futures.kucoin.com/api/v1/contracts/active , jeweils mit unterschiedlicher Authentifizierung und Endpunkten.