KuCoin hat keinen Schalter namens „nur lesen“. Der nur lesende Key ist der mit der Berechtigung General und sonst nichts. SetupBook liest deine Fills mit so einem Key, damit deine USDT-M-Futures- und Spot-Trades ohne Tippen im Tagebuch ankommen. KuCoin verlangt beim Erstellen des Keys auch eine Passphrase, und SetupBook braucht sie. Das dauert etwa fünf Minuten.
Diese Anleitung zeigt jeden Schritt mit Bildern. Wie alle Plattformen sich verbinden, steht in der Übersicht aller Verbindungen. Nutzt du auch MEXC, siehe die MEXC-Anleitung.
Bevor du anfängst
- Ein SetupBook-Konto mit Pro. Das Verbinden einer Plattform gehört zu Pro, und jedes Tagebuch startet mit 14 Tagen davon: 14 Tage gratis starten.
- Ein KuCoin-Konto. KuCoin verlangt beim Erstellen eines Keys eine Sicherheitsprüfung: dein Trading-Passwort sowie einen Code aus deiner E-Mail und aus deiner Authenticator-App.
- Ein Ort, um die Passphrase aufzuschreiben, etwa ein Passwortmanager.
- Fünf Minuten.
Der Key liest nur. Du hakst General an und lässt Spot, Futures, Margin, Earn und Withdrawal aus. SetupBook platziert nie eine Order und bewegt nie Geld. Es speichert Key und Passphrase verschlüsselt auf dem Server und liest damit deine Fills.
1. API Management öffnen und einen Key erstellen
Klick auf der KuCoin-Website auf deinen Avatar, wähl API Management und drück Create API. KuCoin fragt, wofür der Key gedacht ist: Wähl API Trading, die Option, die einen eigenen Key erstellt. Tipp dann einen API name (nenn ihn SetupBook) und eine API passphrase ein.
2. General anhaken und sonst nichts
Hak im Schritt der Berechtigungen General an. KuCoin beschreibt es als beschränkt auf lesende Aktionen: Kontoinformationen, Kontoauszüge und Order-Informationen. Lass Spot, Futures, Margin, Earn und Withdrawal aus, und lass auch jedes andere Kästchen aus. Die Wörter im Formular können je nach Region etwas abweichen (die EU-Seite nennt diesen Schritt API Restrictions), such also das Kästchen General.
IP-Beschränkung: Laut Hilfe von KuCoin muss ein Key, der handelt, an eine IP-Adresse gebunden sein. Deiner handelt nicht, also lass die Beschränkung aus. Besteht das Formular trotzdem darauf, frag uns über das Feedback-Formular unter den Verbindungen: Eine feste Adresse zum Freigeben können wir dir noch nicht nennen. Mit einem nur lesenden Key kann so oder so nichts gehandelt oder ausgezahlt werden.
3. Key, Secret und Passphrase kopieren
Bestätige die Sicherheitsprüfung. KuCoin zeigt den API key und das secret. Kopier beide an einen sicheren Ort, zusammen mit deiner Passphrase. KuCoin kann keines der drei wiederherstellen, wenn es verloren ist; hast du eines verloren, erstell einen neuen Key.
4. Alle drei in SetupBook einfügen
Öffne in SetupBook Konten → Verbindungen und drück Verbindung hinzufügen. Wähl KuCoin. Füg den Key in API-Key, das Secret in API-Secret und die Passphrase in Passphrase ein.
Hak unter Märkte an, was du handelst: USDT-Perpetuals (USDT-M-Futures) und Spot. Für Spot hat KuCoin keinen „Was habe ich gehandelt“-Abruf, schreib also die Paare, die du handelst, in Spot-Paare, durch Kommas getrennt, zum Beispiel BTC-USDT, ETH-USDT. Paare von Coins, die du hältst, kommen von selbst dazu. Futures brauchen keine Liste.
Lass In Konto auf Aus dem Plattformkonto anlegen oder wähl eines deiner Konten, und drück Key prüfen und verbinden.
KuCoin verrät einem Key seine Berechtigungen nicht selbst, SetupBook kann dich also nicht warnen, wenn du aus Versehen ein Handelskästchen angehakt hast. Schau einmal bei KuCoin in die Berechtigungen des Keys, um sicherzugehen.
5. Den ersten Sync beobachten
Der erste Sync startet sofort. Futures reichen etwa drei Monate zurück; Spot wird Paar für Paar gelesen, so weit KuCoin es liefert. Ist er fertig, zeigt die Verbindung Aktiv, die Zeit des letzten Syncs und die Zahl der Trades. Danach sucht SetupBook jede Stunde nach neuen Fills, und du kannst jederzeit Jetzt syncen drücken.
Was du bekommst:
- Positionen, nicht lose Fills. Fills werden so zu Positionen gruppiert wie beim Dateiimport, ein in drei Teilen geschlossener Trade ist also ein Trade mit drei Ausstiegen.
- Kontraktgröße. Ein Futures-Kontrakt ist eine feste Menge des Coins wert (der BTC-Kontrakt XBTUSDTM ist 0,001 BTC), und SetupBook nutzt das, damit Größe und Ergebnis zu KuCoin passen.
- Gesperrte Felder. Symbol, Richtung, Zeiten, Preise, Größe, Gebühren und das Netto-Ergebnis kommen von KuCoin und bleiben exakt (sie speisen dein Netto-Gewinn/Verlust). Plan, Setup-Qualität, Fehler, Notizen und Screenshots bleiben deine.
- Zeitzone. Die Zeiten von KuCoin sind UTC, du musst also nichts einstellen.
- Nicht enthalten. Coin-margined-Kontrakte (inverse) und Funding-Zahlungen werden nicht gelesen.
Demo oder Live
SetupBook verbindet bei KuCoin nur Live-Konten. KuCoin hat kein Demo-Trading, das SetupBook lesen kann.
Einen Key ersetzen
Öffne das Menü der Verbindung, wähl Bearbeiten und drück Schlüssel ersetzen. Füg den neuen Key, das Secret und die Passphrase ein und speichere: SetupBook prüft sie, vergisst die alten und nutzt die neuen ab dem nächsten Sync. Die Trades bleiben.
Probleme
Probleme beim Verbinden? Schreib uns von der Verbindungsseite aus, mit dem, was du versucht hast. Wir antworten jeden Tag per E-Mail innerhalb von 30 Minuten.
Häufige Fragen
Ist das sicher? Kann SetupBook handeln oder auszahlen?
Nein. Ein Key nur mit General kann keine Order platzieren und nichts auszahlen, und SetupBook hat keinen Code, der es versucht. Key und Passphrase liegen verschlüsselt auf dem Server und werden nie an deinen Browser gesendet. Willst du aufhören, lösch den Key bei KuCoin, und die Verbindung stoppt.
Warum braucht SetupBook die Passphrase?
KuCoin signiert jede Anfrage mit der Passphrase zusätzlich zu Key und Secret. Ohne sie lehnt KuCoin die Anfrage ab. Die Passphrase hast du beim Erstellen des Keys selbst gewählt.
Muss ich die IP-Adresse beschränken?
Nein. Lass sie aus. Eine feste Adresse zum Freigeben können wir dir noch nicht nennen; willst du eine, frag uns im Feedback-Formular. Ein nur lesender Key kann mit oder ohne IP-Regel nicht handeln oder auszahlen.
Warum muss ich meine Spot-Paare auflisten?
KuCoin hat keinen Abruf, der die gehandelten Spot-Paare liefert. Du listest die Paare, und SetupBook ergänzt die Paare der Coins, die du hältst. Futures brauchen keine Liste.
Kostet das etwas?
Das Verbinden gehört zu Pro. Jedes Tagebuch startet mit 14 Tagen Pro, und in diesen 14 Tagen wird nichts abgebucht. Kündigst du vorher, bleibst du im kostenlosen Plan, der die manuelle Eingabe behält.
Lieber eine Datei? Der Import geht weiter: siehe das Handbuch. Um eine andere Börse zu verbinden, lies die Hyperliquid-Anleitung.