How do I get my KuCoin API key?
API is the initially preferred method of integration.
If necessary, additional CSV files can be uploaded afterwards. When uploading CSV files, make sure to avoid transaction duplicates. More information on this can be found under CSV file upload.
Log in to your KuCoin account.
Click on the profile button in the upper-right corner and select API Management.
Now click on Create API.
Important: Enter a name for your API key and "blockpit" as passphrase.
Grant only the General API key permission, as shown in the image below.
Also select No for IP restriction.
Now click Next and confirm with your trading, e-mail and 2FA codes and activate your API key.
Your API key and Secret are now visible in the API-List.
Your Secret is now shown only once and available to copy!To import your data, you must first create an Integration in the Blockpit Web App.
To do so, navigate to the menu item Integrations in your Dashboard and click on +Integration.Select KuCoin from the list of exchanges, and then copy the API key and the Secret into the designated fields. Confirm your entries by clicking Continue.
🧮 When using subaccounts, a separate Blockpit Integration must be created for each subaccount.
💡 Tip: If you are unable to create an Integration without "Mismatched Balances" using an initial API integration and additional CSV uploads, try creating a CSV Integration first and then convert your Integration into an API Integration afterwards. In addition, use a current import start date (e.g. import time span: today's date) as a separator to avoid transaction duplicates.
Which data can be imported via KuCoin API?
Your complete transaction history always serves as the basis for your tax report. Preferably, automatic API solutions are used to import your transactions. Our team is committed to implementing all API data provided by your exchange for you.
Using the following list, you can identify all products that are implemented:
Transactions
📅 Transactions older than 365 days are not available via API.
Supported
✅ Crypto Deposits & Withdrawals
(Internal transfers to futures- and/or subaccounts [except automatically generated trading bot subaccounts] are currently imported as Unlabeled Deposits and Withdrawals. These can be merged to Transfer manually by creating a KuCoin futures account or a subaccount, or excluded from your transaction list in general.)
Fees
✅ Fees
✅ KCS (Fees, Refunds)
✅ Spot Market Trades
✅ Leveraged Token Trades
✅ Margin Trades
✅ Converts
✅ Dust
✅ KuCoin Card (Payments & Refunds)
✅ Futures Trades PnL (Profit, Loss, Fee und Funding)
Futures PnL and associated fees are only imported in full when the position is closed.
✅ Earn (Staking)
✅ Rewards & Distributions (KuCoin Event, Rewards, Airdrops)
In case of missing transactions, you can help our support team via chat-request to include them in our import spectrum (if technically possible).
Not Supported
⛔ Fiat Deposits & Withdrawals
⛔ Earn (Savings)
⛔ Trading Bot Transactions
(KuCoin does not provide an API endpoint for internal "Trading Bot Subaccounts". Transfers to and from these subaccounts are imported via API sync as unlabeled deposits and withdrawals. You can manually edit these transactions into Transfers to/from a dedicated Manual Integration ("Trading Bot") to accurately track your capital and record any net profits or losses as realized PnL/Trades once the bot is closed.)
⛔ Fast Trade / P2P / Third Party
⛔ NFTs
⛔ KuCard Inactivity Fee
Missing transactions can be found by comparing the actual history of your exchange. You can then add these directly to your Blockpit Integration by subsequently uploading your CSV file (see below) or by migrating your CSV data into our Excel template.
Synced Balance
Supported
✅ All Account Balances
Temporary Mismatches
👁🗨 Open Futures Positions
Until closing of open/unrelized futures positions, associated assets will not be fully displayed in the Synced Balance of your Blockpit integration. However, this has no effect on the tax report, as it is based on your transactions (Calculated Balance). The resulting Tip: Mismatched Balance can be ignored in this context. The “Auto Balancing” feature should not be used in this exceptional case!
If your Synced Balance is displayed incompletely, you can help our support team via chat-request to include it in our import spectrum (if technically possible).
How do I get my KuCoin CSV file?
Download and upload your KuCoin CSV file
The following steps will help you download your Binance CSV file and import it into Blockpit:
Log into your KuCoin Account.
Navigate to the Orders menu item next to your profile icon and then click on Spot Trade History.
Now click on Export in at the top right.
Next, select the following Markets in the sidebar.
❗ Be sure NOT to use any “Account History_” files.
❗ Be sure to deselect ⚪ the sub-item “Filled Orders (Show Order Splitting)”. (Exception: Trading Bot ➡ Filled Orders (Show Order Splitting) ➡ Spot ✅)
❗ When using Futures products, select only the “Realized PnL” file.
Then select the relevant transaction period (preferably entire tax years from January 1 to December 31) as well as the UTC-0 time zone and CSV file type, then click Confirm below.
💡 When using KuCoin subaccounts, a separate Blockpit Integration must be created for each subaccount. It is therefore best to download your subaccount CSV files separately by selecting “Includes Sub-Accounts” before uploading them to your subaccount integration.
Once the file has been generated, you can download it. We also recommend renaming the file after the corresponding transaction period. (Example: History 2020-01-01 - 2020-12-31)
You can now import the file into Blockpit:
Case 1: Initial Setup (New CSV Integration)
Navigate to the Integrations menu in your Dashboard and click on + Integration > select KuCoin > switch to the CSV tab. (Use this path if you want to track KuCoin purely file-based without an API.)
Case 2: Supplementary Upload (Extend Existing Integration)
In the Dashboard, go to Integrations and click directly on the Upload icon (cloud with an upward arrow) next to the Sync button on your existing KuCoin integration. (Use this path to bridge historical data gaps that precede your API sync timeframe.)
Now drag the corresponding file(s) into the field displayed below and confirm your entry with Save to upload your transactions.
📁 Automatic duplicate detection for file uploads
Our importer automatically compares new uploads against existing CSV, Excel, and manually created transactions, preventing duplicate entries.
✂ Focus on overlapping timeframes: For integrations with existing Exchange (API) or Bockchain transactions, data is technically not matched automatically. Please remove already synchronized timeframes from your file prior to uploading to avoid duplicate transactions.
💡 If the upload of your original CSV file does not work, please try to update your internet browser version first or use an alternative browser to eliminate potential sources of error.
How do I solve problems with my KuCoin Integration?