Data Migration Guide from Koinly to Blockpit

Transitioning from Koinly to Blockpit is a straightforward process. Here's a step-by-step guide.

How can I download my Koinly CSV history?

Your Koinly history can be downloaded as an CSV file as described in the following instructions:

• Log in to your Koinly account.
  
  Navigate to the Transactions menu item and select Export/Import.
  
  
  
  Now Download your transaction history as a CSV file as shown below.
  
  
  
  The file should now be in your download directory.

Things to consider in advance?

• Unfortunately, Koinly does not provide any NFT IDs in the exported CSV files, only the collection ticker. We have therefore developed the following solution:
  
  Specific NFT IDs should be entered in the comment field of the respective transaction in the Koinly user interface before exporting the CSV file, so that Blockpit can read and import them from the CSV file.
  
  Here are the rules for this:
  
  For incoming AND outgoing transactions if both sides are different NFTs: OUT-NFT#124; IN-NFT#125;

  For incoming AND outgoing transactions if only one side is an NFT: OUT-NFT#124 or IN-NFT#125;

  For incoming OR outgoing transactions OR transfers: NFT#123

• Please add your blockchain wallet integrations in advance as standalone integrations in Blockpit so that all assets and especially specific NFTs are automatically created in advance by our database. This will ensure that your assets are selectable in the asset mapping process.
  
  The pre-created integrations should be deleted before the migration process (uploading the CSV file) begins. You can then start the migration process again.
  
  > How to create an automatic Wallet Integration?

➡️ General Steps:

1. Dashboard Start: Begin on the Blockpit dashboard. It will later provide a comprehensive overview of your current portfolio, integrations and latest transactions. 📊
   
   

2. Add Integration: In the top-right corner, click on +Integration.
   
   

   Then click on Tax Tool Migration on the top right.

   
   
   

3. Upload Full History File: This is a pivotal step. Upload your Full History File from Koinly by browsing or drag and drop. 📁

   
   
   
   

4. After successfully uploading the CSV file, click the Continue button to go to the Asset Mapping.

🔍 Asset Mapping:

1. Transition to Asset Mapping: Here, you can match assets from your CSV file to the supported assets in Blockpit.

2. Verify Asset Recognition: Blockpit aims to automatically identify most assets. Ensure the mapping is correct and adjust manually if needed. ✅
   
   
   
   

3. Save Configurations: After confirming the asset matches, save your choices.

4. Then, click the Continue button to navigate to the Label Mapping.
   
   

   Unable to map Scam Tokens?
   
   Should you be unable to map scam tokens due to a missing selection option, you can map them to the placeholder: "SCAM - Scam Token Placeholder".
   
   
   
   
   Having trouble mapping specific Assets or NFT IDs?
   
   If a particular asset or NFT ID isn't available for selection, our database can automatically generate assets. To enable this, set up your Integration as a Synced Wallet first. You might need to cancel the migration process, add the wallets containing these assets one by one as Blockchain/Wallet Integrations, allowing our system to auto-create the assets. Once this step is complete, you can restart the migration process.
   
   Your assets should now be available for selection, and any initially created Integrations that are no longer needed can be removed.
   
   > How to create an automatic Wallet Integration?
   
   If your asset is still not selectable, consider using our Generic Assets as placeholder.
   
   

🔍 Label Mapping:

1. Access Label Mapping Page: This is where you'll map the transaction labels from your old tool to Blockpit's labels. 
   

2. Adjust and Confirm Labels: Blockpit offers suggested matches based on common labels. Check and make manual adjustments as necessary. ✅

   
   

   Most of your transactions will be labeled automatically by Blockpit and can be changed depending on your requirements.
   Custom rates/values are also imported directly.
   
   The labels for Deposits and Withdrawals will be preset as Unlabeled to allow later Auto-Labeling of Transfers upon the completion of the migration dialogue.
   
   > Basics on Labeling and Merging of transactions
   
   Income transactions will be labeled as Mining (for now) until a respective Income Label has been implemented.

3. Lock in Label Mappings: Save your label choices after you've verified them. 

4. Once done, click the Continue button to proceed to the Integration Mapping.

⚙️ Integration Mapping:

1. Access the Integration Mapping Page: After the CSV file upload, you'll be taken to the Integration Mapping dialogue. 

2. Review Recognized Integrations: Blockpit will scan the CSV file and list any recognized integrations. Make sure all your integrations are captured correctly. 
   
   
   
   

3. Setup Sync: Beside each integration, there's a Setup Sync that allows to enable an auto-sync of new transactions and balances for your Exchange and Wallet Integrations upon a certain start date. 🔄

   In the Setup Sync, you can either enter your API credentials or Public Keys, and define the import time span (the start date of the import will be preset to the date of your latest existing transaction).
   
   > Please check the corresponding Integration Articles when setting up your auto-sync.
   
   Important: The Setup Sync can also be carried out later for individual integrations under the Dashboard menu item.
   
   
   
   > Convert a Manual Integration into a Synced Exchange/Wallet Integration
   

4. Click the Continue button to finalize the migration process.

🎉 Finalizing the Migration:

1. Review Integrations: Back on the dashboard, look at the Integrations Tab. Ensure the added wallets and exchanges are display correctly.

2. Check Status and Balances: See the status of each integration, e.g., "Synced: 1 minute ago" for Exchange and Wallet Integrations and check your asset balances as soon as they are synced. 🔄
   
   Balances for Manual Integrations (unsynced) will be displayed instantly.

3. Completion Notification: A notification will appear on your dashboard once the migration is successful.
   
   

4. Auto-Merging of Transfers: Please note that it can currently take a few hours for your Unlabeled Deposits (incoming) and Unlabeled Withdrawals (outgoing) to be detected and automatically merged into a Transfer by our Auto-Merging feature.
   
   It is therefore best to wait until all Transfers have been detected (merged) and trigger a review of your transactions before analyzing your Dashboard!
   
   
   
   > Basics on Labeling and Merging of Transactions

You can now check the Blockpit First Step Article to continue your journey and learn about all basic features and functionalities.