How to Integrate KuCoin and Koinly

Simplify KuCoin tax reporting with Koinly. Integrate via API or CSV to easily calculate the tax liability of your KuCoin transactions, trading and history. Get started for FREE!

API Import CSV File Import

How to integrate KuCoin with Koinly

KuCoin offers a huge host of crypto investment options from buying and trading to futures and mining. Whatever your crypto investments, figuring out your KuCoin taxes and creating your tax report couldn't be easier if you integrate KuCoin with Koinly.

How to get a tax statement from KuCoin

You might be wondering, does KuCoin provide CSV tax and trade history reports? Is it even possible to get tax info and statements from KuCoin? What about a KuCoin tax API? The good news is, while KuCoin might not provide tax forms and documents, KuCoin does offer 2 easy ways to export transaction and trade history!

KuCoin pairs with Koinly through API or CSV file import to make reporting your crypto taxes easy. Once connected, Koinly becomes the ultimate KuCoin tax tool. How? Koinly will calculate your KuCoin taxes based on your location AND generate your EOFY tax report, all within 20 minutes! All you’ll need to do at tax time is download your KuCoin tax statement from Koinly and file it with your local tax authority. Done!

Connect to Koinly with the KuCoin tax report API

On Koinly

  1. Sign up or log in to Koinly and go to the wallets page.
  2. Select add new wallet: KuCoin.
  3. Select setup auto-sync.
  4. Head to your KuCoin account.

On KuCoin

  1. Sign in to your KuCoin account.
  2. Find the drop down tab under your account in the top right corner and select API management.
  3. Select create API.
  4. In the API name box, enter a name, such as "Koinly".
  5. In the API passphrase box, create your passphrase.
  6. Under API restrictions, select general for read-only access.
  7. Under IP restriction, select no.
  8. For security verification, you'll need to enter your trading password that you created when you made your KuCoin account. You'll also need to enter a SMS verification code if you use two-factor authentication.
  9. On the new API pop-up, copy the API key and API secret.

Back to Koinly

  1. Paste the API key into the API key box.
  2. Paste the API secret into the API secret box.
  3. Enter your passphrase you created earlier.
  4. Select secure import.

Good to know

It'll take a few minutes for your KuCoin account to auto-sync with your Koinly account. Koinly is just going through your transaction history and identifying the various taxable events to generate your tax report accurately. KuCoin had a massive update in 2019. For users who had an account prior to this update, there may be some issues with transactions importing incorrectly. Don't worry if this applies to you, you can just use the CSV import file method below instead.
For those using KuCoin futures - this has a separate API which you'll need to integrate with Koinly in addition to the KuCoin API.

How to import your KuCoin tax report CSV file to Koinly

On KuCoin

  1. Sign in to your KuCoin account.
  2. Select orders from the top right corner, then select the type of transaction data you'd like to export from the drop down menu. KuCoin separates transaction history into different CSV files. So there are separate exports for trades, margin trades, deposits and withdrawals and so on. You'll need all of these different transaction files to upload to Koinly to create a complete transaction history.
  3. Once selected, select trade history.
  4. Select your date range.
  5. Select export to CSV.
  6. Select confirm.

On Koinly

  1. Sign in to your Koinly account and head to the wallet page.
  2. Select add new wallet: KuCoin.
  3. Select import from file.
  4. Upload your CSV file.

Good to know

KuCoin CSV files can cover a maximum time period of 100 days, as well as splitting transaction history into different CSV files. For some of our users, this means a lot of separate CSV files! There's an easy way to get around this though. If you contact KuCoin support, you can request your full transaction history. KuCoin support team are normally happy to provide this and you'll end up with one easy, simple file to import instead of multiple files. Another important thing to know is that KuCoin has different files for trades and orders. Koinly only supports trades files from KuCoin. KuCoin has a CSV export limit of 5 CSV files every 24 hours. This isn't a huge problem for most users, but it's a good reason not to leave your tax returns until last minute if you've got a lot of transactions spanning a long period of time!

How do I check that my KuCoin import is accurate?

If there are issues with the data you import from KuCoin, Koinly won't be able to generate an accurate tax report. Check through your KuCoin transactions, as well as any other synced wallets, to make sure all the imported data is accurate. Follow these simple steps to check your imported data is correct.

All wallets, exchanges and blockchains

First things first, sync every crypto exchange and wallet you use with Koinly. This lets Koinly know when you're moving funds between your own wallets, which is tax free. If you don't sync all your accounts, Koinly will see these transactions as withdrawals or deposits, which may be subject to Income Tax or Capital Gains Tax.

Look out for big numbers

Once everything added, go to the transactions page and filter by type. Select deposits and withdrawals from the drop down menu. Take some time to look through these to ensure there aren't any transfers between your own wallets mistakenly appearing as a withdrawal or deposit. You can fix this manually if you see any.

Review the labels of your transactions

Use the wallet filter next. Select your KuCoin wallet. Go through your KuCoin transactions to check they're tagged correctly. Koinly uses tags/labels to understand the type of transaction and apply the right type of tax. Most of the time these are imported automatically, but if you see any missing or incorrect tags, you can add tags in the Koinly platform.

Withdrawal Tags (sending funds):

Whenever you send funds, this is a withdrawal. Koinly sees withdrawals as a disposal of an asset and by default applies Capital Gains Tax as such. However, some withdrawals are not subject to CGT. Label these using withdrawal tags.

  • Tag as cost: Tag any transaction fees.
  • Sent to pool: Tag any assets in liquidity/staking pools as sent to pool so Koinly knows you still own the asset.
  • Tag as lost: Tag any stolen crypto and claim it as a loss, depending on your country's tax rules.
  • Tag as gift: Gifting crypto is tax free in many locations. Check your country's crypto tax rules and tag any gifted crypto.

Deposit Tags (receiving funds):

Whenever you receive funds, this is a deposit Koinly sees deposits as a purchase at market price or an investment. These transactions may be subject to Income Tax or Capital Gains Tax, depending on your location and the reason for the deposit. Label these with deposit tags.

  • Tag as mining: Most countries consider mining to be income, so it's subject to Income Tax.
  • Received from pool: Use this tag to label the original capital you sent to a pool, not any rewards as a result of it.
  • Tag as airdrop: Many tax offices see airdrops as a bonus, making them subject to Income Tax.
  • Tag as reward: Use this to tag any rewards from referral schemes, staking pools and so on. Rewards are often seen as a bonus and subject to Income Tax.
  • Tag as loan interest: Receiving interest from loaning crypto is often seen as income and subject to Income Tax.
  • Tag as income: Like any other salary, getting paid in crypto is subject to Income Tax.
  • Tag as fork: Like airdrops, any new coins from a fork could be seen as a a bonus and subject to Income Tax.

Exchange Tags (trading funds):

Whenever buy crypto with fiat, sell crypto for fiat or trade crypto for crypto - this is an exchange. Buying crypto is not taxed, selling crypto is and trading is sometimes taxed depending on where you live. Koinly calculates all of this for you, so there's only one exchange label you might need.

  • Tag as swap: Use this tag if a cryptocurrency has changed its name/symbol. This is a tax free transaction, like a transfer.

Need more help? Read our Getting Started Guide for more advice on how to get started with Koinly.

How do I troubleshoot my KuCoin integration to Koinly?

Koinly has a great help section, full of common queries and solutions for integrating KuCoin to Koinly. Here are some of the questions we see the most:

To find answers to more specific queries, head to our discussion forum. Don't worry if you still can't find the answer you need, get in touch with our customer support team who will be happy to help.