CoinLedger only needs "Read" or "View" access to import your trade history. This permission protects your accounts. Learn more about API access in this article here.
Jump ahead with this table of contents:
Silent API Import Walkthrough Video
Watch video below and follow along with the written steps in this guide to see how to import your KuCoin transactions, step-by-step.
API Import Walkthrough
Step 1:
Log in to your KuCoin account.
Step 2:
Click on the profile in the upper right corner and select API Management.
Step 3:
Next, select Create API.
Step 4:
On the next page, select API-Based Trading. Ensure that ONLY the General box is selected under API Restrictions. Do not select any other restrictions under this field.
Step 5:
Next, create an API Name and an API Passphrase. The API Name and Passphrase can be anything you want. Just make sure to record the passphrase somewhere as it cannot be found later.
As noted above, set API Restrictions to General to restrict your API Key to read-only access. Also, click No on IP Restriction to ensure your import does not fail. Then, hit Next.
Step 6:
To authorize the creation of your new API keys, enter the Trading Password, Email Verification Code and 2-FA Code on the next page, and once completed select Confirm.
Step 7:
This window is displayed after successful security verification. From this screen you can easily copy your API Key and API Secret.
It is important to save the API Secret and API Passphrase somewhere because they are visible only while creating the API Key.
Step 8:
Navigate to Step 1. Import. Select Add Account then select KuCoin to open up an import tab.
Select Auto-Import then enter your API Key, API Secret and API Passphrase into the correct fields. Click Sync Transactions.
When importing your transaction history via API, you will have the option to specify a start date for your import. 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.
Main Accounts, Trading Accounts and Sub-Accounts: Which do I import from?
The Main Account is primarily intended for sending funds in and out of the KuCoin exchange, while the Trading Account is used for spot trades. More information about these account types can be found here and here, on KuCoin's main website.
It's important to review each account type to make sure you completely import from all KuCoin accounts. If you used multiple trading accounts and sub-accounts, you will need to create separate API keys for each account.
General Overview of Each Account Type
Main Account: This account is used to deposit and withdraw funds on KuCoin. In order to make spot trades on KuCoin you first need to transfer funds from your Main Account to a Trading Account. Main Accounts can also be used for P2P trades and lending. Note that API Keys are not available for Main Accounts. If you had P2P trades on KuCoin you can enter those manually following this guide.
Trading Account: After transferring assets from the Main Account, the Trading Account is used for spot trades and KCS Pay fees. API Keys are available for trading accounts.
Sub-Account: Sub-accounts are customizable and can be used according to the discretion of each KuCoin user. They're often used with trading bots or margin trading. API Keys are available for sub accounts.
KuCoin API Limitations
U.S. users may not have access to API Keys on KuCoin. New U.S. customers are not able to complete KYC on KuCoin. According to recent KuCoin policy changes, this means U.S. users may not have the ability to create API keys on KuCoin. For this reason, we recommend all U.S. users switch to using a CSV File Import instead.
Due to technical limitations on KuCoin's end, their API is now limited to only retrieving data from the past year (going back 365 days from the date of the API sync). Transactions before that 365 day period may not be imported into CoinLedger. We recommend KuCoin users affected by this change switch to using a CSV File Import when importing their data instead.
Due to a limitation in KuCoin's API, transactions before 2/18/2019 may not be imported.
If you traded on KuCoin before then you will need to make sure the API pulled in all of your transactions. If it fails to do so, you can get trade history files that covers all years. Follow this guide to request your KuCoin files prior to 2/18/2019 and this guide to export your files after 2/18/2019 directly from KuCoin.