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.

    Migration Koinly to Blockpit CSV Export.png

    Now Download your transaction history as a CSV file as shown below.

    Migration Koinly to Blockpit CSV History Download.png

    The file should now be in your download directory.


โžก๏ธ 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.

    Tax Tool Migration.png

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

    Tax Tool Migration Koinly to Blockpit.png

  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. โœ…

    Blockpit Accointing Asset Mapping Dialogue.png

  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?
    If a particular asset isn't available for selection, our database can automatically generate unknown 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 unknown 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.

    Generic Assets.png

    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. โœ…

    Tax Tool Migration Koinly to Blockpit - Label Mapping.png

    Most of your transactions will be labeled automatically by Blockpit and can be changed depending on your requirements.

    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. 

    Tax Tool Migration Koinly to Blockpit - Integration Mapping.png

  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.

    Setup Sync Manual Integration.png

    > 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.

    Blockpit Accointing Migration completed.png

  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!

    Recalculate Transactions.png

    > 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.



How do I start the migration completely from scratch?

If you have made a mistake during the migration, you can either edit individual transactions afterward, delete and re-add individual integrations (for this, delete all other exchanges/wallets from your CSV file and start the migration again), or start the migration completely anew by deleting all existing integrations.

To do this, go to the account settings and select Delete Data.

Delete Data.png

Was this article helpful?