This page introduces the trade types that can be obtained via Kucoin API and exchange file.
Contents
1．Period for which history can be obtained via API
-
Only transaction history from 1 year can be retrieved
Due to exchange limitations, only 1 year of transaction history can be automatically retrieved. To include older transactions, please upload a file obtained from the exchange or create and upload a Custom File.
-
Please re-sync the API manually at least once every 1 years
Transaction history older than 1 years will not be reflected, so it is necessary to perform regular API re-synchronization within that period after linking.
2．Our Support Status for Kucoin
| Trades | File support | API support | API endpoint |
| Spot Trades | ✔ |
✔ |
Spot Trades |
| Bonus and Staking history | × |
✔ |
Bonus and Staking history |
| Margin Trades (cross) | × |
✔ *1 |
Margin Trades(cross) |
| Margin Trades (isolated) | × |
✔ *1 |
Margin Trades(isolated) |
| Withdrawals | ✔ | ✔ | Withdrawals |
| Convert | ✔ | ✔ | Bonus and Staking history |
| Futures/Transactions | × | ✔ | KuCoin Futures/Transactions |
| Pre-Market | × | ✔ | Bonus and Staking history |
| Crypto Lending Pro | × | ✔ | Bonus and Staking history |
| Spotlight | × | ✔ *2 | Bonus and Staking history |
|
P2P Fiat Trades |
✔ | × | |
| Mining Pool | × | × | |
| Cloud Mining | × | × | |
| NFT | × | × | |
| Leveraged tokens | × | × | |
| Flexible Savings | × | × | |
| Buy Crypto with Fiat | × |
× *3 |
*1: It has been confirmed that, due to the specifications of the exchange's API, borrowing/repayment history cannot be retrieved using a read-only API key. We apologize for the inconvenience, but please upload the history using a custom file.
*2 Regarding Spotlight (AKE), if you purchased AKE using both USDC and KCS, the exchange does not provide full information of the transaction. Therefore, such transactions cannot be reflected through API integration. On the other hand, other Spotlight transaction histories are reflected without issue.
Accordingly, we kindly ask you to upload your AKE purchase history via a custom file.
*3 Since the exchange does not provide sufficient information on buy crypto (fiat) history through their API, this type of transaction is not currently supported via API
Other important notes:
*Please note that for the following transactions, we are unable to automatically provide support as the necessary information is not delivered through the API. We appreciate your understanding in advance:
-
- Dust conversion to KCS
- Redeem (Refund of redemption)
* Since the exchange does not provide settlement currency or price information for BOMB launchpad via API, we have recorded the transaction using the price of 0.008 USDT based on data published on KuCoin’s website. If you paid with KCS or at a different price, please manually edit the transaction to correct the price and settlement currency accordingly.
How to Edit/Exclude/Delete transactions
3．Transactions Not Automatically Reflected via API or File
If you can identify the details of your transactions—such as by checking them on the exchange’s interface—please create a Custom File and enter the transactions yourself before uploading it.
Custom File for any other trades
How to upload a Custom File
【Related Articles】
How to get trade history from KuCoinHow to get an API key for KuCoin