Importing from Koinly

Checked against app build 2026-08-26-01-41 on 2026-08-26.

Which Koinly export do I need?

Your transactions, exported from Koinly as CSV. Both of Koinly’s export shapes are understood, including the full account export, so whichever you have will read.

Koinly users move over with one file. Take the complete history rather than a single year, the reason is below.

How does the import work?

Open Import in the sidebar and choose the file. The preview appears before anything is added.

It shows 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 from Koinly?

Your transactions, not Koinly’s tax calculation.

Trades, transfers, staking rewards and fees come across, 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.

What should I watch out for?

Import the complete history, not a single year.

The UK rules need your earliest acquisitions to price your latest disposals correctly, see the UK rules. 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.