How to Integrate Koinly and Huobi

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

API Import CSV File Import

How to integrate Huobi with Koinly

One of the largest global exchanges, Huobi exchange offers crypto investors more than 364 different cryptocurrencies and 57 local currencies, as well as options like margin trading, futures trading and more.

How to get a tax statement from Huobi

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

Huobi pairs with Koinly through API or CSV file import to make reporting your crypto taxes easy. Once connected, Koinly becomes the ultimate Huobi tax tool. How? Koinly will calculate your Huobi 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 Huobi tax statement from Koinly and file it with your local tax authority. Done!


Connect to Koinly with the Huobi tax report API

On Huobi

  1. Log in to Huobi.
  2. Select your profile icon in the top right corner.
  3. Select API management from the drop down menu.
  4. Enter a name for your API Key, for example, Koinly.
  5. Under permission settings, check read-only.
  6. Select create.
  7. Read the risk warning pop-up, check the boxes and select I understand.
  8. Enter the security authentication code sent to your email address.
  9. Copy the access key and the secret key.

On Koinly

  1. Sign up or log in into Koinly and head to the wallets page.
  2. Add a new wallet: Huobi.
  3. Paste the access key and secret key.
  4. Select secure import.

Good to know
Trades older than 4 months cannot be imported with Huobi API. If you have trades older than this, use the CSV file method below instead.

How to import your Huobi tax report CSV file to Koinly

On Koinly

  1. Sign up or log in to your Koinly account and head to the wallets page.
  2. Select add new wallet: Huobi.
  3. Select import from file.
  4. Head over to Huobi.

On Huobi

  1. Log in to your Huobi account.
  2. In the top right corner, select orders.
  3. From the drop down menu, select exchange & margin orders.
  4. Select order history.
  5. Select your date range (up to 4 months).
  6. In the top right corner of the order history section, select the export icon. It looks like a sheet.
  7. From here, head back up into the top navigation bar and select balances.
  8. Select exchange account (deposit and withdrawal).
  9. In top right corner, select history.
  10. There is no way to export this data, so you'll need to add deposit, withdrawal, conversion and other history manually in Koinly or create your own CSV file to import. Read our guide on how to add transactions manually or our guide on how to create a custom CSV file.

Back to Koinly

  1. Upload your CSV file or files.
  2. Select import.
  3. Manually add your transactions if necessary.

Good to know

Huobi only lets you export 4 months worth of transaction data at a time. If you have more transaction data, you'll need to export these in four month time frames and upload each to Koinly.

The lack of export capability on Huobi is bearable for those who don't trade regularly. However, for investors with old Huobi accounts or investors with hundreds of transactions, manually adding all this information is tedious to say the least! Thankfully, there is a way to get around this.

On the same page you find your deposit and withdrawal transactions, there should be some text that reads, "If you want to view more data, click here to file an application."

This link will take you to a page where you can request that Huobi create a CSV file of your complete transaction data. All you need to do is fill out the form letting Huobi know why you want the data, what data you'd like included and what date range to include. You'll also need to verify your account with ID to make this request.

Huobi state they respond to these data requests within 5 business days.

How do I check that my Huobi import is accurate?

Koinly is smart, but if there are problems with the data you import, our crypto tax software can't generate an accurate Huobi tax report for you. This is why we recommend you always check through your Huobi transaction history once you've imported your data. This lets you identify and resolve any issues, so Koinly can create an accurate crypto tax report. We recommend the following simple steps to check your tax report.

All wallets, exchanges and blockchains

Make sure you sync all the wallets and exchanges you use. If you miss this step, Koinly can't identify when you're moving funds between your own wallets, which is tax free. Instead, it'll identify these as deposits or withdrawals, which are subject to tax.

Look out for big numbers

Once all your wallets are connected, go to the transactions page. You can filter the type of transaction by withdrawals and deposits. Use this to spot any withdrawals or deposits you think are transfers between wallets. You can fix these manually.

Review the labels of your transactions

Use the wallet filter option on the transaction to bring up your Huobi trades specifically. Then take a little time to review your transaction labels. As Huobi's CSV export function is so limited, you may notice issues with the way your transactions are labelled. Don't worry, you can label your transactions in the Koinly interface.

Withdrawal Tags (sending funds):

Any time you send coins, Koinly treats this as an asset disposal as standard, making withdrawals subject to Capital Gains Tax. However, some disposals are tax free, depending on your location. Use withdrawal labels to tag these.

  • Tag as gift: Gifting crypto is tax free in lots of countries. Check your country's crypto tax rules and tag any gifted crypto.
  • Tag as lost: Tag any stolen crypto as lost and claim it as a loss, depending on location.
  • Tag as cost: The cost tag is used to label any transaction fees.
  • Sent to Pool: Tag any coins or tokens sent to a staking pool with this label so Koinly knows you still hold the asset.

Deposit Tags (receiving funds):

Any time you receive coins, Koinly treats this as a purchase at market price or investment. However, there are times when you receive new coins when this would be considered income and therefore subject to Income Tax instead. You can use deposit tags to label these.

  • Tag as airdrop: Lots of countries see airdrops as a bonus, subjecting them to Income Tax instead of Capital Gains Tax.
  • Tag as fork: Like above, any new coins due to a fork could be considered a bonus and therefore subject to Income Tax.
  • Tag as loan interest: Loaning crypto and receiving interest as a result is often subject to Income Tax.
  • Tag as income: Getting paid in crypto is subject to Income Tax, just like a salary.
  • Received from Pool: Use this tag to label the original capital you sent to a given pool, not any rewards from it.
  • Tag as reward: Use this to tag any rewards received from things like staking pools and referral schemes. Rewards are often considered as a type of bonus and subject to Income Tax.

Exchange Tags (trading funds):

Any time you trade crypto for crypto, buy crypto with fiat or sell crypto for fiat, this is an exchange. Koinly identifies these trades based on your imported data and calculates taxes accordingly. There is only one tag you could need for an exchange transaction.

  • Tag as swap: The swap tag is used if a coin has changed its name or symbol. This type of transaction is tax free as you didn't gain or dispose of an asset.

If you'd like further advice, our Getting Started Guide is a great resource that can help you learn how to use Koinly, as well as learn how to resolve common issues.

How do I troubleshoot my Huobi integration to Koinly?

Koinly has a help section, filled with common queries from our users and great answers from our customer support team. Some of our most common Huobi queries include:

If you can't find the answers in our help section, try our Koinly community, where our users discuss everything crypto. Alternatively, you can get in touch with our customer support team for more advice.