There are multiple ways to import your KuCoin trading history into CoinLedger. One of these ways is via the CSV files they export from their site. Below we'll cover each of these options, including our recommended method as well as two alternatives, and then provide step-by-step instructions for each. Jump ahead with this table of contents:
Recommended File Import Method
Step 1
Head to the KuCoin account portal and then access their Export Dashboard by selecting Export History.
Step 2
Then, click Export in the top right corner, and select each of the following transaction categories below:
Deposit/Withdrawal > select all file types
Spot Orders > select Show Order Splitting file only
Convert Orders > select all file types
Earn Orders > select Profit History file only
Please don't select any of the other file types as they may cause your import to fail.
Next, select 1 Year for your range of time, and .csv as your file type.
Finally, download the CSV by pressing Confirm.
Step 3
After generating the file, KuCoin will notify you when it's ready to be exported. Press Download and save the zip files to a convenient location. Your zip file will contain files for each of the transaction categories you selected in Step 2.
Step 4
Head to CoinLedger, and add a new KuCoin account from Step 1: Import.
Then, import EACH of the CSV files you received from KuCoin into CoinLedger by selecting them individually and pressing Upload.
When importing a transaction history CSV, you will have the option to specify a start date for your import under the Drag and Drop Files Here box. This feature is designed to prevent duplicate data from being imported. You can access this feature by hitting the Import Settings drop down menu, as shown below, and then specifying a date for your import to start from. All transactions after this date will be imported. You should not do this if you are importing all of your transactions into CoinLedger for the first time.
Trade History File
Important information about the Trade History file from KuCoin
1. The KuCoin Trade History file does not include fiat buys (a fiat buy is when you trade USD or other fiat currencies for crypto). There are a few options for getting these imported:
Option 1: If it’s a few buys those can be added manually in-app in Step 1. Import
Option 2: Locate the original buys in KuCoin and then add them to the Manual Import template file.
Option 3: Download the Deposits and Withdrawals file which includes the crypto amounts as deposits. Once the deposits are imported into CoinLedger you can go into your account in the Review stage and edit the transactions and add the USD amount for each buy to the trade.
2. If you traded on KuCoin before 2019 you will need to request a CSV file from their customer support team, as these trades are not included in API or website file export. To request the file that includes full transaction history contact KuCoin Support website. More information is in this guide.
3. The KuCoin Trade History file does not include income transactions (airdrops, mining income, staking or interest income, etc.). To import those, please jump to the Income File section of this guide.
Step-by-step Import Instructions
Step 1:
Login to your KuCoin account.
Step 2:
Navigate to the Trade History page following this link or the steps below.
Step 3:
Click the green Save as CSV button (not the Export History button) and then click Customize to use the following options to prepare your CSV files.
Step 4:
Export your trades by selecting a custom date range.
Important: KuCoin has a limit of 100 days per export so use the following date ranges to download your trades for each year of trading:
January 1st - March 31st
April 1st - June 30th
July 1st - September 30th
October 1st - December 31st
Step 5:
Wait for the KuCoin to generate your files and then navigate to the download page or follow the steps below.
Once there, download each file by clicking the download icon to the right:
Step 6:
Extract the .zip file. The correct file should start with TRADE.
Step 7:
You will see a file in .csv format after extracting the .zip file. Navigate to Step 1. Import. Select Add Account then choose the KuCoin tab on CoinLedger. Click on Upload File and drag your CSV file into the box to import your transactions.
When importing a transaction history CSV, you will have the option to specify a start date for your import under the Drag and Drop Files Here box. This feature is designed to prevent duplicate data from being imported. You can access this feature by hitting the Import Settings drop down menu, as shown below, and then specifying a date for your import to start from. All transactions after this date will be imported. You should not do this if you are importing all of your transactions into CoinLedger for the first time.
Income File
In contrast to the Trade History file, the Transaction History file contains all of your income events (airdrops, mining income, staking or interest income, etc.).
Step 1:
Login to your KuCoin account.
Step 2:
Navigate to your Main Account wallet.
Step 3:
Click on Account Details.
Step 4:
Click on "Export to CSV" and Export your transactions by selecting a custom date range. Repeat this step for each coin as needed.
Important: KuCoin has a limit of 100 days per export so use the following date ranges to download your trades for each year of trading:
January 1st - March 31st
April 1st - June 30th
July 1st - September 30th
October 1st - December 31st
Step 5:
You'll receive a notification in your KuCoin account when your files are ready. Click on the notification to be brought to the downloads page and download each file.
Step 5:
Extract each .zip file.
Step 6:
You will see a file in .csv format after extracting each .zip file. Navigate to Step 1. Import. Select Add Account then choose the KuCoin tab on CoinLedger. Click on Upload File and drag each of your CSV files into the box to import your transactions.
When importing a transaction history CSV, you will have the option to specify a start date for your import under the Drag and Drop Files Here box. This feature is designed to prevent duplicate data from being imported. You can access this feature by hitting the Import Settings drop down menu, as shown below, and then specifying a date for your import to start from. All transactions after this date will be imported. You should not do this if you are importing all of your transactions into CoinLedger for the first time.