Der Wechsel von Koinly zu Blockpit funktioniert über einen CSV-Export: Du lädst deine Transaktionshistorie in Koinly herunter und lädst sie in Blockpit unter + Integration › Tax Tool › Koinly hoch. Danach ordnest du Assets, Labels und Integrationen zu.
Phase | Was du tust |
1 Export | Koinly › Transactions › Export/Import › Download (CSV) |
2 Vorbereiten | NFT-IDs im Kommentarfeld ergänzen, Wallets vorab anlegen und wieder löschen |
3 Upload | Dashboard › „+ Integration“ › „Tax Tool“ › „Koinly“, CSV-Datei hochladen |
4 Mapping | Asset Mapping, Label Mapping, Integration Mapping nacheinander bestätigen |
5 Prüfen | Integrationen, Balance und Transfers kontrollieren |
Wie lade ich meine Koinly CSV-Historie herunter?
Guide: Koinly Historie als CSV-Datei herunterladen
1️⃣ Logge dich in deinen Koinly Account ein.
2️⃣ Öffne den Menüpunkt Transactions und wähle Export/Import.
3️⃣ Lade mit Download deine Transaktionshistorie als CSV-Datei herunter.
4️⃣ Die Datei liegt jetzt in deinem Downloadverzeichnis.
Was ist vorab zu beachten?
Wichtig: Meine Koinly CSV-Datei enthält NFT Transaktionen?
Der Export liefert keine NFT-IDs, sondern nur den Collection-Ticker. Trage deshalb die spezifischen NFT-IDs in der Oberfläche vor dem Export in das Kommentarfeld der jeweiligen Transaktion ein, damit Blockpit sie aus der Datei lesen kann. Die Regeln:
▸ Eingehend UND ausgehend, beide Seiten unterschiedliche NFTs: OUT-NFT#124; IN-NFT#125;
▸ Eingehend UND ausgehend, nur eine Seite ist ein NFT: OUT-NFT#124 oder IN-NFT#125;
▸ Eingehend ODER ausgehend ODER Transfers: NFT#123
Warum sollte ich meine Blockchain-Wallets einmalig vorab in Blockpit anlegen?
Lege deine Blockchain-Wallets vorab als eigenständige Integrationen in Blockpit an. Dann erstellt unsere Datenbank alle Assets und insbesondere spezifische NFTs automatisch, und deine Assets sind im Asset-Mapping auswählbar.
Die vorab angelegten Integrationen löschst du vor dem Start der Migration (Upload der CSV-Datei) wieder. Danach startest du den Migrationsprozess erneut.
Wie lade ich meine Koinly CSV-Historie bei Blockpit hoch?
➡️ Allgemeine Schritte
1️⃣ Dashboard: Beginne auf dem Blockpit-Dashboard.
2️⃣ Integration hinzufügen: Öffne den Reiter Integrationen (Dashboard) und klicke auf + Integration. Klicke auf Tax Tool und wähle Koinly.
3️⃣ Vollständige Transaktionshistorie hochladen: Lade deine vollständige Historie von Koinly hoch, entweder per Suche oder per Drag & Drop.
4️⃣ Nach dem erfolgreichen Hochladen der CSV-Datei klickst du auf Weiter, um zum Asset Mapping zu gelangen.
🔍 Asset Mapping
1️⃣ Auf der Asset-Mapping-Seite ordnest du Assets aus deiner CSV-Datei den in Blockpit unterstützten Assets zu.
2️⃣ Asseterkennung überprüfen: Blockpit identifiziert die meisten Assets automatisch. Prüfe, ob alles passt, und passe es bei Bedarf manuell an.
💡 Exotischere Assets ordnest du am sichersten zu, indem du die Token- oder Contract-Adresse einfügst.
3️⃣ Konfigurationen speichern: Speichere deine Auswahl, wenn alles passt.
4️⃣ Klicke auf Weiter, um zum Label Mapping zu gelangen.
Bestimmter Scam-Token nicht auswählbar?
Wenn du einen Scam-Token mangels Auswahlmöglichkeit nicht mappen kannst, ordne ihn dem Platzhalter SCAM - Scam Token Placeholder zu.
Bestimmte Assets oder NFT-IDs nicht auswählbar?
Lässt sich ein Asset oder eine NFT-ID nicht zuweisen, dann hilft dies: Die Datenbank erstellt Assets automatisch, wenn du die Integration vorab als Synced Wallet anlegst. Du kannst den Migrationsprozess also vorübergehend abbrechen und die Wallets mit den unbekannten Assets einzeln als Blockchain/Wallet-Integration hinzufügen. Deine Assets sind danach auswählbar, und die vorab angelegten Integrationen kannst du wieder löschen. Danach startest du die Migration erneut.
Ist dein Asset immer noch nicht auswählbar, nutze generische Assets als Platzhalter.
Spezialfall LUNA & LUNC
Koinly verwendet in der CSV-Datei (nicht in der Oberfläche) für LUNA und LUNC nur einen gemeinsamen Ticker. Blockpit korrigiert das beim Import, es gibt keine falschen Asset-Zuordnungen.
🔍 Label Mapping
1️⃣ Auf der Label-Mapping-Seite ordnest du die Labels deiner alten Transaktionen den Blockpit-Labels zu.
2️⃣ Labels anpassen und bestätigen: Blockpit stellt gängige Labels standardmäßig ein. Prüfe die Voreinstellungen und passe sie bei Bedarf an.
💡 Die meisten Transaktionen versieht Blockpit automatisch mit Labels. Du kannst sie ändern.
Merged Trades aus Koinly werden direkt als Trade importiert, auch benutzerdefinierte Werte (Custom Values) übernimmt Blockpit direkt.
Einzahlungen (Deposits) und Auszahlungen (Withdrawals) setzt Blockpit standardmäßig auf Unlabeled, damit nach dem Migrationsdialog das Auto-Merging von Transfers greifen kann. Income erhält vorerst das Label Mining, bis ein Income-Label umgesetzt ist.
3️⃣ Labels festlegen: Speichere deine Auswahl, wenn alles passt.
4️⃣ Klicke auf Weiter, um zum Integration Mapping zu gelangen.
⚙️ Integration Mapping
1️⃣ Auf der Integration-Mapping-Seite ordnest du deine alten Daten genau zu.
2️⃣ Erkannte Integrationen prüfen: Blockpit liest deine CSV-Datei und zeigt die erkannten Integrationen. Prüfe, ob alles korrekt erfasst wurde.
3️⃣ Sync einrichten: Hier stellst du einen automatischen Sync (Setup Sync) für neue Transaktionen und Salden ein.
💡 Im Setup Sync gibst du deine API-Zugangsdaten oder deinen Public Key ein und legst den Importzeitraum fest. Das Startdatum des Imports ist standardmäßig das Datum deiner letzten vorhandenen Transaktion.
⚠️ Achtung: Der Setup Sync lässt sich auch nachträglich im Dashboard für einzelne Integrationen nachholen.
4️⃣ Klicke auf Weiter, um den Migrationsprozess abzuschließen.
🎉 Migration abschließen
1️⃣ Integrationen überprüfen: Öffne im Dashboard den Reiter Integrationen und prüfe, ob alles korrekt angezeigt wird.
2️⃣ Status und Balance überprüfen: Schau dir den Status jeder Integration an, z. B. Synchronisiert: vor 1 Minute bei Börsen- und Wallet-Integrationen, und prüfe die Asset-Balance, sobald sie synchronisiert sind.
♻ Balances von manuellen CSV/Excel-Integrationen (nicht synchronisiert) siehst du immer sofort.
3️⃣ Abschlussbenachrichtigung: Bei erfolgreicher Migration erscheint eine Benachrichtigung auf deinem Dashboard.
4️⃣ Auto-Merging von Transfers: Es kann aktuell einige Stunden dauern, bis das Auto-Merging deine Unlabeled Deposits (Eingang) und Withdrawals (Ausgang) automatisch zu einem Transfer verbindet. Warte mit der Analyse am besten, bis alle Transfers erkannt sind, und starte vor dem Blick ins Dashboard eine Prüfung deiner Transaktionen.
💡 Lies als Nächstes den Artikel über die ersten Schritte in Blockpit, um weitere Funktionen kennenzulernen.
Typische Fehler und wie du sie vermeidest
⚠️ Typische Fehler
✗ NFT-IDs nicht im Kommentarfeld ergänzt → Blockpit kennt nur den Collection-Ticker, einzelne NFTs lassen sich nicht zuordnen
✗ Zusätzlich zur Migration API-Integrationen derselben Börse angelegt → Transaktionen kommen doppelt (Duplikate), nutze ein Startdatum oder bleibe bei einem Weg
✗ Importzeitraum im Setup Sync früher als deine letzte migrierte Transaktion → Transaktionen können doppelt vorkommen
✗ Vorab angelegte Wallet-Integrationen nicht vor dem Upload gelöscht → Assets und Transaktionen doppelt, lösche sie und starte neu
✗ Transfers sofort nach dem Upload ausgewertet → Deposits und Withdrawals sind noch Unlabeled, warte auf das Auto-Merging (einige Stunden)
Wie starte ich die Migration vollständig neu?
Ist dir bei der Migration ein Fehler unterlaufen, hast du drei Wege: einzelne Transaktionen nachträglich bearbeiten, einzelne Integrationen löschen und neu hinzufügen (lösche dazu alle anderen Exchanges/Wallets aus deiner Datei und starte die Migration neu) oder durch Löschen aller bestehenden Integrationen die Migration vollständig neu starten. Dazu gehst du in die Account-Einstellungen und wählst Daten löschen.