TurboTax is one of the most popular platforms in the US to file your taxes. Koinly simplifies your tax filing by providing a ready-to-use export with all your crypto disposals that can be added to TurboTax.
You can check also our comprehensive blog post on TurboTax filing:
TurboTax Online 2025
☝️ Before you begin
🚨 Complete these steps to avoid issues in Turbotax
If you skip any of the steps below, TurboTax report will be incomplete and you'll need to fix it manually for each transaction after importing it to Turbotax
Check your data
Check the data you imported to Koinly and fix any outstanding errors. Follow How to ensure your Tax Report is accurate. In particular:Fix all "missing purchase history" warnings (you shouldn't have any disposals with $0.00 cost basis)
Fix all "missing market price" warnings (you shouldn't have any disposals with $0.00 proceeds)
Complete the 1099-DA flow
On the "Tax Reports" page, mark whether you received a 1099-DA or not for each wallet listed in "Pending" section - "Pending" section should be empty
🇺🇸 USA: Uploading 1099-DA forms to Koinly
Generate the TurboTax report
On the "Tax Reports" page, select "Turbotax (Gain/Loss)" and click "Generate". Unzip the file once downloadedThe file will contain one PDF for each of your wallets (with all blockchain wallets added to one "Non custodial" PDF)
If you had more than 900 disposals in a particular wallet, there will be multiple PDFs (part-1, part-2, etc.) for this wallet
💸 Adding capital gains
To import your gains/losses from trading cryptocurrencies:
Log in to TurboTax
Go to Federal → Income and click "Add/Edit" next to Investments and Savings
When asked "Did you have investment income in 2025?" select Yes
On the screen "Save time and connect your financial accounts" click Enter a different way
Select the Upload button and click Continue
Upload the first PDF from the zip you downloaded from Koinly
Wait for the file to be processed
Repeat for each PDF from the zip
Transactions from each PDF will be added as its own section under "Koinly" group
🔎 Review imported capital gains
ℹ️ "Needs review" can be ignored in some cases
If all the data Koinly's PDFs contained was imported (i.e., Turbotax didn't skip any fields such as cost basis, proceeds, or date sold) then the "Needs Review" prompt can be ignored
Some imported sections may say "Review Needed"
In most cases, clicking "Review" and "Continue" 3 times clears this
In some cases, it's necessary to:
Click "Review"
Click "Edit" next to any transaction
Click "Continue" - TurboTax will highlight "How did you receive this asset"
Do nothing - click "Back"
Click "Continue" and "Continue"
TurboTax's PDF upload isn't perfect and may randomly miss some data that the PDF contains (e.g. empty Date Sold, empty Cost Basis, etc.). Check your transactions and add the missing data manually if this happens
💸 Adding totals only
If you had a lot of transactions or a lot of wallets, importing each PDF Koinly generated may be cumbersome. Turbotax also has a limit in how many transactions you can import this way (around 9000).
You can instead provide only the totals and attach a statement PDF to your return:
Log in to TurboTax
Go to Federal → Income and click "Add/Edit" next to Investments and Savings
When asked "Did you have investment income in 2025?" select Yes
On the screen "Save time and connect your financial accounts" click Enter a different way
Select Type it myself, then 1099-DA
Type the provider name (Koinly) and click Continue
In the next screens, select:
Did you receive a 1099-DA? Yes
Do you have more than 3 sales? Yes (4+)
Did you buy every investment listed? Yes
Choose how to enter your sales: Sales section totals
Log into Koinly and generate the IRS 8949 Form (Summary) report, then open the summary PDF
Back in TurboTax, add one sales entry, selecting the correct "Applicable checkbox on form 8949" and pasting the proceeds and cost basis from Koinly's PDF. Then repeat for each row in the summary PDF with values
Once done, click Continue
Upload the statement PDF in the dropbox, click Continue
⛏️ Adding income
☝️ 1099-MISC
If you received a 1099-MISC for any of your crypto income, you should add it separately and deduct it from the total income you add in the "Digital assets not reported anywhere else" section
To add your income from mining or staking crypto:
Check the total income for the year on the "Tax Reports" page in Koinly
Log in to Turbotax
Go to Federal → Income, scroll down and expand "Less common income"
Click Start next to "Miscellaneous Income, 1099-A, 1099-C"
Click Start next to "Digital assets not reported anywhere else"
Enter your total income in the next field and click Continue
🛠️ Common issues
Asset name and amount are not populated
After importing the file, you click "Needs Review" and all the rows say "Untitled"
Usually, the data is imported and TurboTax is just lagging with displaying it.
Try to
Click edit next to any disposal
(in the edit window, you will see that the name/amount are actually there)Click back
The data should now be visible again
If this didn't help - it means Turbotax didn't process the file completely. You will need to add the missing data manually or try to delete it and upload again.
File is not accepted
You are trying to import the PDF but the import fails with an error:
We're having trouble with some of your docs
name_of_your_file.pdf
We tried, but couldn’t use this file to auto-fill your return.
This happens when TurboTax's servers are under heavy load. Unfortunately, there is no way around it but try to import the file again later.
I'm asked to review each transaction
This happens if you didn't complete the ☝️ Before you begin section. Go back to Koinly to fix your transaction history and export a new TurboTax report afterwards.
Turbotax Desktop 2025
🚨 TurboTax Desktop doesn't support 1099-DAs
TurboTax didn't yet update their TXF format and it does not support the new boxes on the 8949 form (that regard to 1099-DA). Because of that there is no way for Koinly to provide a file that includes this information
💸 Adding capital gains
Generate the "TurboTax Desktop TXF" report from Koinly
Open TurboTax Desktop
Click File → Import → From TXF Files
Select the file you exported from Koinly
After importing the file, you will need to edit every disposal and select the correct 8949 box manually
💸 Adding totals only
You can follow similar steps from Turbotax Online if you want to report totals only, but TurboTax desktop doesn't have the option to import a PDF at the end - you will get a reminder that the additional statement will need to be mailed (by post).
💸 Importing gains from TurboTax Online
You can also import data to TurboTax Online (the free version) following TurboTax Online > Adding capital gains and the automatically load it to your TurboTax Desktop:
Import all the PDFs from Koinly's TurboTax report to TurboTax Online
Launch TurboTax Desktop
From the start screen, under section Manage your returns (at the bottom) select continue from TurboTax Online
Follow on-screen instructions to log into TurboTax Online and import the data
TurboTax Online 2024
TurboTax Online 2024
Check out our comprehensive blog on all things TurboTax & crypto.
To get started, you’ll need to import your transaction data into Koinly and generate the TurboTax (Gain/Loss Export). If you have income, you will also need to download the Complete Tax Report. Once you have all of this, head over to TurboTax.
We’ll cover steps for TurboTax Online first, and then TurboTax desktop after.
Adding capital gains
Go to Income & Expenses (or Wages & Income)
Select Start/Review/Edit
Select Add/Edit next to Investments and Savings (1099-B, 1099-INT, 1099-DIV, 1099-K, Crypto)
On the next page, answer Yes to the question Did you have investment income in 2024?
On the next page, select Enter a different way
On the next page, select cryptocurrency, then continue
On the next page, select upload it from my computer, then continue
Select other from the drop-down menu for What’s the name of the name of the crypto service you used?
Under name, enter Koinly
Under CSV type, select Gain/Loss Report or Form 1099-B, then continue
Upload your Koinly TurboTax Export (Gain/Loss) file
Select Review and then continue
Compare your totals from your original Koinly report to the totals recorded in TurboTax. TurboTax rounds your figures, so a small difference is normal. Once you’re happy, select continue
Adding income
Go to Wages & Income
Select Add More Income
Select Less Common Income
Next to Miscellaneous Income (1099-A, 1099-C), select Start/Revisit
Next to Other Reportable Income, select Start/Revisit
Answer Yes to Any other taxable income?
Enter a description (for example, crypto mining).
Take the total amount from the Income Summary section of your Koinly Complete Tax Report and enter this into the amount box.
Select continue and review this section
Select done
☝️ 1099-MISC
If you received a 1099-MISC from a centralized crypto exchange, you may need to report your income differently to avoid reporting duplicate income
Troubleshooting Turbotax Online 2024
If you encounter this warning, read through the instructions and make sure you've followed each step in this article carefully:
The most common reasons for this error are:
You are importing the wrong file. Be sure to follow our instructions and choose "TurboTax Export (Gains/Loss)" not "Transaction History" as the type of report you generate.
You have more than 3,000 lines in the report (this is TurboTax's limit). If this is the case, you need to split the file into smaller amounts, e.g. two files with 1,500 in each.
The dates are in the wrong format. If you open the file before uploading it, your device settings can change the format and make it unreadable to TurboTax. Try generating a new report and importing it again without opening it first.
The file format is not correct - If you open the file in Excel beforehand, it may change the type from .csv to .xlsx making in incompatible with TurboTax.
Why is Turbotax asking me to review all transactions? (US)
This review was only recently added to the Online version of Turbotax but the CD/Download version has a similar review section.
This section is entirely optional and can simply be skipped by clicking on the Continue button. It's a nice option to have but most active traders do not fill in this section since there are so many transactions.
This review section will come up for anyone who imports a CSV file to Turbotax as it's not possible to include this additional information in the CSV file itself.
If you have more than 4000 disposals:
TurboTax allows up to 4,000 imported transactions. If you exceed this limit, Koinly will aggregate your transactions while preserving your long-term and short-term gains.
For more information, check our article about Report Aggregation.
TurboTax is saying my file is not compatible:
The date format needs to be correct for the US (MM/DD/YYYY) for all transactions
If it's not, make sure your home country is set to USA on the Settings page and generate the report again.
ℹ️ Some users have also reported difficulty uploading Koinly’s TurboTax file with TurboTax Online. This appears to be in relation to an alternative CSV file upload page within TurboTax, so make sure to follow the exact steps we provided above.
TurboTax Desktop 2024
TurboTax Desktop 2024
Log in and go to your tax return
Select file from the top navigation
Select import
Select upload crypto sales
Select other for What’s the name of the crypto service you used?
Enter a description, select Gain/Loss or 1099-B and select continue
Select upload it from my computer
Upload your Koinly TurboTax Export (Gain/Loss) file
Review your transactions








