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.

Note 1: Main account and Sub-accounts

KuCoin trading account API Keys cannot access data from the KuCoin sub-accounts. To import transactions from the sub-accounts, log into every sub-account and create a new API Key. The process of creating a new API Key for the sub-account is exactly the same as for the main account.

Note 2: 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 export your KuCoin files prior to 2/18/2019 and this guide for files after 2/18/2019 directly from the site or send a request for your complete trade history to the KuCoin support like it is explained here.

Note 3: Due to a limitation in KuCoin API, we cannot process the KCS dust conversion trades.

You can look up these trades at https://www.kucoin.com/assets/trade-account/convertKCS/record and import them manually. Please reach out to our Customer Support team if you have any further questions about this.

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:

Select Create API

Step 4:

Create an API Name and an API Passphrase. The API Name and Passphrase can be anything you want. Just make sure to record the passhphrase somewhere as it cannot be found later.

Set API Restrictions to General, to restrict your API Key to read-only access.

Click No on IP Restriction to enable read-only access your transaction history.

Step 5:

Enter the Trading Password, Email Verification Code and 2-FA Code and select Confirm.

Next you will receive an API Activation email that looks like this. Select Click Activate API

Step 6:

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 7:


Navigate to Step 1. Import. Select Add Account then select the 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.

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.

Did this answer your question?