Importing from Koinly

This page is a stub. The full guide is written against the shipped app version and is on its way.

Koinly users move over with one file. Export your transactions from Koinly as CSV, both of Koinly’s export shapes are understood, including the full account export, so whichever you have will read.

The import. Open Import in the sidebar and choose the file. The preview appears before anything is added, how many rows the file held, how many were read, and how many tax events they become. A Koinly export of 17 rows might become 16 tax events, and the preview shows exactly why, line by line, a money-only fee row set aside here, a transfer pair linked there. Koinly counts rows, gains.tax counts tax events, and the difference is always shown, never assumed. If the preview matches what you expect, confirm the add.

What carries over. Trades, transfers, staking rewards and fees, with dates, amounts and your GBP valuations where the file carries them. What does not carry over is Koinly’s tax calculation, and that is the point, the engine recomputes everything under the UK matching rules and shows the rule per disposal, so you can compare its answers against what you were shown before.

Worth knowing. Import the complete history, not a single year, the UK rules need your earliest acquisitions to price your latest disposals correctly. If the transaction count after import differs from what you expected, the reconciliation count explains how rows become events, and count mismatch covers the cases that need a second look.