Step-by-step guide to importing KuCoin trade history into TradingAtlas via read-only API sync or CSV upload. Set up a read-only API key, fix common errors, and track PnL and taxes.
KuCoin offers a broad altcoin spot market plus KuCoin Futures perpetuals. Its API requires a version-2 key and a passphrase set during creation.
Connect a read-only KuCoin API v2 key with passphrase, or upload spot and futures CSVs. Altcoin pairs are normalised even when symbols use non-standard formats.
Quick facts
API sync
Yes
API status
Read-only API v2 (passphrase required), plus CSV
CSV import
Yes
CSV exports supported
Spot trade history, Futures trade history, Deposit / withdrawal history
Futures / perpetuals
Yes
Funding fees
Yes
Connect KuCoin via API (recommended)
Create a read-only KuCoin API key so trades sync automatically.
1Log in to KuCoin.
2Click your avatar and choose API Management.
3Click Create API.
4Enter an API name such as TradingAtlas.
5Create an API passphrase and save it securely.
6Select only General permission for read-only account data.
7Do not select Trade, Margin, Futures, or Transfer permissions.
8Optionally add IP restrictions.
9Complete trading password, 2FA, and email verification.
10Copy the API Key, Secret, and Passphrase.
11Paste all three values into TradingAtlas, click Test, then Save Connection.
Required KuCoin API permissions
Read-only access is all TradingAtlas ever needs — never enable trading or withdrawals.
✓General
Passphrase required
KuCoin requires the passphrase you set when creating the API key. It is not your login password and cannot be recovered — store it safely and paste it into the passphrase field in TradingAtlas.
Import KuCoin via CSV
Prefer files? CSV upload works for every account.
1Open your KuCoin account and locate the trade history / statements export.
2Export your full KuCoin trade history as CSV (export spot and futures history separately if they are split).
3Export deposits, withdrawals, and fee records if provided separately.
4Open TradingAtlas and go to Import → CSV.
5Upload the KuCoin files — columns are detected and mapped automatically.
6Review the normalized trades and confirm the import.
KuCoin CSV exports TradingAtlas reads
Upload any or all of these — they are merged into one timeline.
✓Spot trade history
✓Futures trade history
✓Deposit / withdrawal history
Known KuCoin quirks
Platform-specific behavior that affects imports.
✓Requires API key version 2 with a passphrase — version 1 keys can fail signing.
✓Sub-accounts export separately and must each be imported.
✓Many low-cap pairs use non-standard symbol formats.
Common KuCoin import issues
Quick fixes for the problems traders hit most often.
✓Use API key version 2 — version 1 keys can fail signing.
✓Using API key version 1 instead of version 2 can break signing.
✓Transfer permission is not needed and should remain disabled.
Security best practices
✓Use a dedicated API key for TradingAtlas.
✓Enable IP whitelist if the exchange supports it and you have a stable IP.
✓Rotate keys periodically and delete keys you no longer use.
✓Never share API secrets in chat, email, screenshots, or support tickets.
What happens after import
Once your KuCoin trades are imported, TradingAtlas builds an automated trading journal, calculates realized PnL and win rate, and prepares cost-basis data for tax reporting — all from the same normalized history.
Frequently asked questions
How do I import my KuCoin trades into TradingAtlas?
Connect a read-only KuCoin API key for automatic sync, or upload KuCoin CSV exports (Spot trade history, Futures trade history, Deposit / withdrawal history).
What KuCoin API permissions do I need?
Read-only access only — General. Never enable trading or withdrawal permissions.
Which KuCoin CSV exports work?
Yes. Upload KuCoin CSV exports — Spot trade history, Futures trade history, Deposit / withdrawal history — and columns are detected and mapped automatically.
Are there any KuCoin quirks I should know about?
Requires API key version 2 with a passphrase — version 1 keys can fail signing.
My KuCoin import isn't working — what should I check?
Use API key version 2 — version 1 keys can fail signing.
Is my KuCoin data secure?
API keys are read-only and stored encrypted. TradingAtlas can never trade or withdraw from your account.
Import your KuCoin trades now
Connect KuCoin via read-only API or CSV and start tracking PnL and taxes.