Anleitung zur Datenmigration von Koinly zu Blockpit

Der Wechsel von Koinly zu Blockpit ist einfach. Diese schrittweise Anleitung hilft dir bei der Migration deiner Daten.

Wie komme ich an meine Koinly CSV Historie?

Deine Koinly Transaktionshistorie kann als CSV-Datei wie in folgender Anleitung beschrieben heruntergeladen werden:

• Logge dich in deinen Koinly Account ein.
  
  Navigiere zum Menüpunkt Transactions und wähle Export/Import.
  
  
  
  Lade nun mittels Download deine Transaktionshistorie als CSV-Datei wie unterhalb dargestellt herunter.
  
  
  
  Die Datei solle jetzt in deinem Downloadverzeichnis zu finden sein.

Was ist vorab zu beachten?

• Leider liefert Koinly in der exportierten CSV-Dateien keine NFT-IDs, sondern nur den Collection-Ticker. Daher haben wir die folgende Lösung entwickelt:
  
  Spezifische NFT-IDs sollten in der Koinly Benutzeroberfläche vor dem Export der CSV-Datei in das Kommentarfeld der jeweiligen Transaktion eingegeben werden, damit Blockpit diese aus der CSV-Datei lesen und importieren kann.
  
  

  Hier sind die Regeln dafür:
  
  Für eingehende UND ausgehende Transaktionen, wenn beide Seiten unterschiedliche NFTs sind: OUT-NFT#124; IN-NFT#125;

  Für eingehende UND ausgehende Transaktionen, wenn nur eine Seite eine NFT ist: OUT-NFT#124 oder IN-NFT#125;

  Für eingehende ODER ausgehende Transaktionen ODER Transfers: NFT#123

• Bitte füge deine Blockchain-Wallet Integrationen vorab als eigenständige Integrationen in Blockpit hinzu, damit alle Assets und insbesondere spezifische NFTs vorab automatisch von unserer Datenbank erstellt werden. So stellst du sicher, dass deine Assets im Asset-Mapping Vorgang auswählbar sind.
  
  Die vorab erstellen Integrationen sollten vor Beginn des Migrationsprozesses (Upload der CSV-Datei) wieder gelöscht werden. Anschließend kannst du den Migrationsprozess erneut starten.
  
  > Wie lege ich eine automatische Wallet Integration an?

➡️ Allgemeine Schritte:

1. Dashboard Start: Beginne auf dem Blockpit-Dashboard. Später bietet es dir einen umfassenden Überblick über dein aktuelles Portfolio, Integrationen, die neuesten Transaktionen und vieles mehr. 📊

2. Integration hinzufügen: Klicke oben rechts auf +Integration.
   
   Klicke oben rechts auf Steuer-Tool Migration.
   
   
   
   

3. Vollständige Transaktionshistorie hochladen: Ein wichtiger Schritt! Lade deine vollständige Historie von Koinly hoch, entweder durch Suchen oder per Drag & Drop. 📁
   
   
   
   

4. Nach dem erfolgreichen Hochladen der CSV-Datei, klicke auf Weiter, um zum Asset Mapping zu gelangen. 

🔍 Asset Mapping:

1. Die Asset Mapping Seite: Hier kannst du Assets aus deiner CSV-Datei den in Blockpit unterstützten Assets zuordnen. 

2. Asseterkennung überprüfen: Blockpit versucht automatisch, die meisten Assets zu identifizieren. Stelle sicher, dass alles passt und passe bei Bedarf manuell an. ✅
   
   
   
   Tipp: Der sicherste Weg, um exotischere Assets in der Asset-Mapping-Sektion der Token-Migration zuzuordnen, ist das einfache Einfügen der Token- oder Kontrast-Adresse.
   
   

3. Konfigurationen speichern: Nachdem du alles überprüft hast, speichere deine Auswahl. 

4. Danach klicke auf Weiter, um zum Label Mapping zu gelangen. 
   
   

   Bestimmter Scam-Token nicht auswählbar?
   
   Solltest du am Mapping von Scam Tokens aufgrund einer fehlenden Auswahlmöglichkeit scheitern, so kannst du diese auf das den Platzhalter: "SCAM - Scam Token Placeholder" mappen.
   
   
   
   
   Bestimmte Assets oder NFT-IDs nicht auswählbar?
   
   Ist ein bestimmtes Asset oder eine NFT-ID aufgrund einer fehlenden Auswahloption nicht zuweisen können, solltest du wissen, dass Assets automatisch von unserer Datenbank erstellt werden, wenn du deine Integration im Voraus als Synced Wallet erstellst. Das bedeutet, dass du den Migrationsprozess vorübergehend abbrechen und die Wallets, die die unbekannten Assets enthalten, einzeln als Blockchain/Wallet-Integration hinzufügen kannst, um die automatische Erstellung deiner Assets vorab zu ermöglichen.
   
   > Wie lege ich eine automatische Wallet Integration an?
   
   Deine Assets sollten somit auswählbar sein und die ursprünglich erstellten Integrationen können gelöscht werden. Anschließend kannst du den Migrationsprozess erneut starten.
   
   Wenn dein Asset immer noch nicht auswählbar sind, kannst du generische Assets als Platzhalter verwenden.
   
   
   
   
   Spezialfall LUNA & LUNC
   
   Koinly verwendet in der CSV-Datei (nicht UI) für LUNA und LUNC nur einen gemeinsamen Ticker. Dies wird von Blockpit über den Import korrigiert, sodass es keine Probleme mit falschen Asset-Zuordnungen gibt.
   

🔍 Label Mapping:

1. Die Label Mapping Seite: Hier ordnest du die Labels deiner alten Transaktionen den Labels von Blockpit zu. 

2. Labels anpassen und bestätigen: Blockpit schlägt gängige Labels zur Verfügung und stellt diese standardmäßig ein. Überprüfe die Voreinstellungen und mache bei Bedarf manuelle Anpassungen. ✅
   
   

   Die meisten deiner Transaktionen werden automatisch von Blockpit mit Labels versehen. Diese können je nach deinen Anforderungen geändert werden.
   Merged Trades aus Koinly werden direkt als Trade importiert.
   Auch Custom Werte/Values werden direkt übernommen.
   
   Die Bezeichnungen für Deposits (Einzahlungen) und Withdrawals (Auszahlungen) werden standardmäßig auf Unlabeled gesetzt, um späteres Auto-Merging von Transfers nach Abschluss des Migrationsdialogs zu ermöglichen.
   
   > Basiswissen für das Labeling und Merging von Transaktionen
   
   Income wird vorerst mit dem Label Mining versehen, bis ein entsprechendes Income-Label implementiert ist.

3. Labels festlegen: Wenn alles passt, speichere deine Auswahl. 

4. Klicke anschließend auf Weiter, um zum Integration Mapping zu gelangen. 

⚙️ Integration Mapping:

1. Die Integration Mapping Seite: Hier geht's um die genaue Zuordnung deiner alten Daten. 

2. Erkannte Integrationen überprüfen: Blockpit checkt deine CSV-Datei und zeigt erkannte Integrationen. Prüfe, ob alles korrekt erfasst wurde. 
   
   
   
   

3. Sync einrichten: Hier kannst du einen automatischen Sync (Setup Sync) für neue Transaktionen und Salden einstellen. 🔄

   Im Setup Sync kannst du entweder deine API-Zugangsdaten oder Public Key eingeben und den Importzeitraum festlegen (das Startdatum des Imports wird standardmäßig auf das Datum deiner letzten vorhandenen Transaktion gesetzt).
   
   > Bitte informiere dich vorab in den Leitfäden über die entsprechenden Exchange und Wallet Integrationen, wenn du deine Auto-Synchronisation einrichtest. 
   
   Wichtig: Der Setup Sync kann auch nachträglich noch im Menüpunkt Dashboard für einzelne Integrationen nachgeholt werden.
   
   
   
   > Wie wandle ich eine Manuelle Integration in eine Synced Exchange/Wallet Integration um?
   

4. Klicke auf Weiter, um den Migrationsprozess abzuschließen. 

🎉 Migration abschließen:

1. Integrationen überprüfen: Schau dir im Dashboard den Integrationen-Tab an. Stell sicher, dass alles korrekt angezeigt wird. 

2. Status und Balance überprüfen: Schau dir den Status jeder Integration an und prüfe deine Asset-Balance, z.B. "Synchronisiert: vor 1 Minute" für Börsen- und Wallet-Integrationen und überprüfe deine Asset-Balance, sobald sie synchronisiert sind. 🔄 

   Salden für manuelle Integrationen (nicht synchronisiert) werden immer sofort angezeigt.

3. Abschlussbenachrichtigung: Wenn die Migration erfolgreich war, erscheint eine Benachrichtigung auf deinem Dashboard. 
   
   

4. Auto-Merging von Transfer: Bitte beachte, dass es aktuell einige Stunden dauern kann, bis deine Unlabeled Deposits (Eingang) und Unlabeled Withdrawals (Ausgang) von unserem Auto-Merging Feature erfasst und automatisch zu einem Transfer verbunden (merged) werden.
   
   Warte mit der Analyse deiner Transaktionen daher am besten ab, bis alle Transfers erkannt (merged) wurden und starte vor der Betrachtung deines Dashboards eine Prüfung deiner Transaktionen!
   
   
   
   > Basiswissen für das Labeling und Merging von Transaktionen
   
   

Bitte lies unseren Artikel über die ersten Schritte in Blockpit, um mehr über weitere Funktionen und Features zu erfahren. Viel Spaß! 🚀