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.
Wähle rechts oben in deinem Profil API-Mangement.
Klicke nun auf Create API.
Wichtig: Trage als Passphrase "blockpit" ein.
Erteile die im Bild angeführten API-Key-Berechtigung "General".
Verwende vorerst keine IP Restriktionen.
Klicke auf Weiter und bestätige mit deinen Trading-, E-Mail sowie 2FA Codes und aktiviere deine API Key.
Dein API Key und Secret wird jetzt in der API-Liste angezeigt.
Dein Secret wird einmalig angezeigt und ist somit nur kurzfristig kopierbar.Damit du deine Daten einfügen kannst, musst du in der Blockpit Web-App zuerst eine Integration erstellen. Navigiere dazu im Dashboard auf den Menüpunkt Integrationen und klicke anschließend auf +Integration.
Wähle KuCoin aus der Liste der Exchanges 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.
Welche Daten sind mittels KuCoin API-Key importierbar?
Als Grundlage deines Steuerberichts dient immer dein vollständiger Transaktionsverlauf. Automatische API Lösungen zum Import deiner Transaktionen sind zu bevorzugen. Unser Team ist angehalten, alle von deiner Börse zur Verfügung gestellten API Daten für dich zu implementieren.
Anhand folgender Auflistung kannst du alle implementierten Produkte erkennen:
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)
✅ Futures Trades PnL (Profit, Loss, Fee und Funding)
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)
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.
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
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.
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!
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.
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:
Logge dich in deinen KuCoin Account ein.
Navigiere neben deinem Profil-Symbol zum Menüpunkt Orders und klicke anschließend auf Spot Trade History.
Klicke nun rechts oben auf Export.
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.
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.
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)
Nun kannst du die Datei in Blockpit importieren:
Fall 1: Erste Einrichtung (Neue CSV-Integration)
Navigiere im Dashboard auf den Menüpunkt Integrationen und klicke anschließend auf + Integration > wähle KuCoin > wechsle auf den Reiter CSV. (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
Unser Importer gleicht neue Uploads automatisch mit bereits bestehenden CSV-, Excel- und manuellen erstellten Transaktionen ab und verhindert so doppelte Einträge.
✂ Fokus auf überschneidende Zeiträume: Bei Integrationen mit bestehenden Exchange (API)- oder Blockchain-Transaktionen werden Daten technisch bedingt nicht automatisch abgeglichen. Bitte entferne deshalb bereits synchronisierte Zeiträume vorab aus deiner Datei, um doppelte Transaktionen zu vermeiden.
💡 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.
Wie löse ich Probleme mit meiner KuCoin Integration?