Auf einen Blick
👁️ Blockpit importiert KuCoin-Transaktionen per API-Key oder aus einer CSV-Datei: Krypto Einzahlungen & Auszahlungen, Gebühren, KCS und Spot Market Trades. Importweg: API · CSV |
Wie erhalte ich meinen KuCoin API-Key?
API ist die initial bevorzugte Art der Integration.
Falls notwendig, können im Anschluss zusätzliche CSV-Dateien hochgeladen werden. Achte beim Upload von CSV-Dateien darauf, Transaktions-Duplikate zu vermeiden. Näheres dazu im Unterpunkt CSV-Datei Upload.
2️⃣ Wähle rechts oben in deinem Profil API-Mangement.
3️⃣ Klicke nun auf Create API.
4️⃣ Wichtig: Trage als Passphrase blockpit ein.
5️⃣ Erteile die im Bild angeführten API-Key-Berechtigung General.
6️⃣ Verwende vorerst keine IP Restriktionen.
7️⃣ Klicke auf Weiter und bestätige mit deinen Trading-, E-Mail sowie 2FA Codes und aktiviere deine API Key.
8️⃣ Dein API Key und Secret wird jetzt in der API-Liste angezeigt.
Dein Secret wird einmalig angezeigt und ist somit nur kurzfristig kopierbar.
9️⃣ Öffne + Integration (oder im Dashboard im Reiter Integrationen auf + Integration).
🔟 Wähle KuCoin in der Liste der Exchanges (Dialog KuCoin hinzufügen) und kopiere anschließend den API-Key und das Secret in die dafür vorgesehenen Felder. Bestätige deine Eingaben mit Weiter.
🧮 Bei der Verwendung von KuCoin Subaccounts muss für jeden Subaccount in eine eigene Blockpit Integration erstellt werden.
💡 Solltest du mittels initialer API Integration und zusätzlichem CSV-Upload keine Integration ohne "abweichende Balances" herbeiführen können, erstelle zuerst eine CSV-Integration und wandle deine Integration anschließend in eine API Integration um. Verwende zudem ein aktuelles Import-Startdatum (z.b. Import Zeitspanne: heutiges Datum) als Trennpunkt, um Transaktions-Duplikate zu vermeiden.
Wie erhalte ich meine KuCoin CSV-Datei?
KuCoin CSV-Datei herunterladen und importieren
Die folgenden Schritte helfen dir, deine KuCoin CSV-Datei herunterzuladen und in Blockpit zu importieren:
1️⃣ Logge dich in deinen KuCoin Account ein.
2️⃣ Navigiere neben deinem Profil-Symbol zum Menüpunkt Orders und klicke anschließend auf Spot Trade History.
3️⃣ Klicke nun rechts oben auf Export.
4️⃣ Wähle anschließend in der Seitenleiste folgenden Markets aus.
❗ Achte darauf, KEINE Account History_ bzw. Kontoverlauf_ Dateien zu verwenden.
❗ Achte darauf, den Unterpunkt Filled Orders (Show Order Splitting) abzuwählen ⚪. (Ausnahme: Trading Bot ➡ Filled Orders (Show Order Splitting) ➡ Spot ✅)
❗ Wähle bei Verwendung von Futures Produkten ausschließlich die Realized PnL Datei.
5️⃣ Wähle in der Seitenleiste den entsprechenden Transaktionszeitraum (bevorzugt ganze Steuerjahre von 01.01 bis 31.12) sowie die Zeitzone UTC-0 und File Type CSV aus, klicke unterhalb auf Confirm.
💡 Bei der Verwendung von KuCoin Subaccounts muss für jeden Subaccount in eine eigene Blockpit Integration erstellt werden. Lade deine Subaccount CSV-Dateien daher am besten gesondert unter Auswahl von Includes Sub-Accounts herunter, bevor du sie in deine Subaccount Integration hochlädst.
6️⃣ Sobald die Datei generiert wurde, kannst du diese herunterladen. Wir empfehlen die Datei zudem nachträglich nach dem entsprechenden Transaktionszeitraum zu benennen. (Beispiel: Historie 2020-01-01 - 2020-12-31)
7️⃣ Nun kannst du die Datei in Blockpit importieren:
Fall 1: Erste Einrichtung (Neue CSV-Integration)
Navigiere im
Dashboardauf den Menüpunkt Integrationen und klicke anschließend auf+ Integration> wähle KuCoin > wechsle auf den ReiterCSV. (Nutze diesen Weg, wenn du KuCoin rein dateibasiert ohne API führen möchtest.)Fall 2: Ergänzender Upload (Bestehende Integration erweitern)Gehe im Dashboard auf Integrationen und klicke bei deiner bestehenden KuCoin-Integration direkt auf das
Upload-Icon(Wolke mit Pfeil nach oben) neben dem Sync-Button. (Nutze diesen Weg, um historische Lücken einer bestehenden API-Integration vor dem Sync-Zeitraum zu schließen.)
Ziehe nun die entsprechende(n) Datei(en) in das unterhalb dargestellte Feld und bestätige deine Eingabe mit
Speichern, um deine Transaktionen hochzuladen.
📁 Automatische Erkennung von Duplikaten bei Datei-Uploads
Blockpit prüft jeden Upload je Integration auf Duplikate (Zeitpunkt, Ein-/Ausgang und Gebühr) und überspringt sie. Enthält die Integration schon Transaktionen, übernimmt Blockpit nur Transaktionen nach der neuesten vorhandenen, ohne Meldung. Mit API-Daten gleicht Blockpit nicht ab: Entferne überschneidende Zeiträume vorher aus der Datei.
💡 Sollte der Upload deiner originalen CSV-Datei nicht funktionieren, versuche bitte zuerst deine Internet-Browser Version zu aktualisieren oder verwende einen alternativen Browser, um mögliche Fehlerquellen auszuschließen.
Was nach dem Import passiert
Nach Weiter erscheint die Integration im Dashboard im Reiter Integrationen; die einzelnen Transaktionen findest du unter Transaktionen.
Neue Transaktionen holst du später mit dem Sync-Symbol der Integration oder mit Alle syncen. Weicht die Synced Balance von der berechneten Balance ab, zeigt Blockpit den Hinweis Abweichende Balance.
Weitere Dateien lädst du im Dashboard über das Upload-Symbol (Wolke) deiner Integration hoch.
Die Integration kannst du jederzeit bearbeiten oder löschen: > Wie erstelle, synchronisiere, bearbeite, gruppiere, wandle, lösche oder deaktiviere ich eine Integration?
Welche Daten sind mittels KuCoin API-Key importierbar?
Transaktionen
📅 Transaktionen, die länger als 365 Tage zurückliegen, sind nicht über API verfügbar.
Supported
✅ Krypto Einzahlungen & Auszahlungen (Interne Transfers an Futures- sowie Subaccounts (exklusive automatisch generierte Trading Bot Subaccounts) werden aktuell als Ein- und Auszahlung mit Hinweis: Fehlendes Label (Ein/Aus) importiert. Diese können durch Erstellen einer KuCoin Futures Integration oder einer Subaccount Integration manuell zu Transfers gemerged werden oder grundsätzlich aus der Transaktionsliste ausgenommen werden.)
✅ Gebühren
✅ KCS (Gebühren, Refunds)
✅ Spot Market Trades
✅ Leveraged Token Trades
✅ Margin Trades
✅ Converts
✅ Dust
✅ KuCoin Card (Payments & Refunds)
Die Futures PnL und zugehörige Gebühren werden erst beim Schließen der Position vollständig importiert.
✅ Earn (Staking)
✅ Rewards & Distributions (KuCoin Event, Rewards, Airdrops)
Not Supported
⛔ Fiat Einzahlungen & Auszahlungen
⛔ Earn (Savings)
⛔ Trading Bot Transaktionen (Für interne Trading Bot Subaccounts stellt KuCoin börsenseitig keine API-Schnittstelle bereit. Transfers dorthin werden über den API-Sync als ungelabelte Ein- und Auszahlungen importiert. Du kannst diese Transaktionen manuell zu Transfers in/aus einer eigens angelegten Manuellen Integration (Trading Bot) editieren, um dein Kapital sauber abzubilden und Gewinne bzw. Verluste nach Beendigung des Bots pauschal als Realized PnL/Trade zu erfassen.)
⛔ Fast Trade / P2P / Third Party
⛔ NFTs
⛔ KuCard Inactivity Fee
Synced Balance
Supported
✅ Alle Account Balances
Vorübergehende Abweichungen
👁🗨 Offene Futures Positionen
Bis zum Schließen offener/unrealisierter Futures Position werden zugehörige Assets nicht vollständig in der Synced Balance deiner Blockpit Integration angezeigt. Dies hat jedoch keine Auswirkungen auf den Steuerbericht, da dieser auf deinen Transaktionen (Berechente Balance) basiert. Der dadurch entstehende Hinweis: Abweichende Balance kann in diesem Fall ignoriert werden. Die "Balance-Auto-Korrektur" Funktion sollte in diesem Ausnahmefall nicht verwendet werden!
Wie löse ich Probleme mit meiner KuCoin Integration?
Sollte es dennoch zu fehlenden Transaktionen gekommen sein, kannst du unserem Support-Team per Chat-Anfrage helfen, diese (sofern technisch möglich) in unser Importspektrum aufzunehmen.
Fehlende Transaktionen können durch Abgleich mit dem tatsächlichen Verlauf deiner Börse gefunden werden. Diese kannst du nachträglich direkt mittels CSV-Datei Upload (siehe unterhalb) oder mittels Migration deiner CSV Daten in unsere Blockpit Excel Vorlage in deine Blockpit Integration hinzufügen.
Sollte deine Synced Balance unvollständig angezeigt werden, kannst du unserem Support-Team per Chat-Anfrage helfen, diese (sofern technisch möglich) in unser Importspektrum aufzunehmen.
⚠️ Typische Fehler
✗ Secret nicht sofort kopiert → das Secret wird nur einmal angezeigt und ist nur kurzfristig kopierbar
✗ Subaccount mit dem Haupt-Key erwartet → jeder Subaccount braucht eine eigene Blockpit Integration mit eigenem Subaccount-API-Key
✗ Datei mit Zeitraum hochgeladen, den die API schon liefert → Duplikate, weil API-Daten nicht abgeglichen werden; entferne überschneidende Zeiträume vorher aus der Datei
✗ Upload der Originaldatei schlägt fehl → Internet-Browser aktualisieren oder einen anderen Browser verwenden