Step-by-step guide to importing HTX 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.
Create a read-only HTX API key so trades sync automatically.
1Log in to HTX.
2Open API Management from your profile or security menu.
3Click Create API Key.
4Enter a tag/name such as TradingAtlas.
5Select Read-only or Account Information permissions only.
6Leave Trade/Order and Withdraw disabled.
7Optionally bind trusted IP addresses.
8Complete security verification.
9Copy the Access Key and Secret Key.
10Paste them into TradingAtlas as API Key and API Secret, click Test, then Save Connection.
Required HTX API permissions
Read-only access is all TradingAtlas ever needs — never enable trading or withdrawals.
✓Read-only
✓Account Information
Import HTX via CSV
Prefer files? CSV upload works for every account.
1Open your HTX account and locate the trade history / statements export.
2Export your full HTX 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 HTX files — columns are detected and mapped automatically.
6Review the normalized trades and confirm the import.
HTX CSV exports TradingAtlas reads
Upload any or all of these — they are merged into one timeline.
✓Spot trade history
✓Derivatives history
✓Account statements
Known HTX quirks
Platform-specific behavior that affects imports.
✓Legacy Huobi naming still appears across some screens and docs.
✓Symbols can use lowercase or concatenated formats.
Common HTX import issues
Quick fixes for the problems traders hit most often.
✓Use your current HTX account — legacy Huobi naming can cause confusion.
✓Paste the Access Key as API Key and the Secret Key as API Secret.
✓Huobi and HTX naming can be confusing; use the current HTX account.
✓Binding no IP may reduce key lifetime for keys with elevated permissions.
✓Trading permissions are not required for TradingAtlas.
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 HTX 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 HTX trades into TradingAtlas?
Connect a read-only HTX API key for automatic sync, or upload HTX CSV exports (Spot trade history, Derivatives history, Account statements).
What HTX API permissions do I need?
Read-only access only — Read-only, Account Information. Never enable trading or withdrawal permissions.
Which HTX CSV exports work?
Yes. Upload HTX CSV exports — Spot trade history, Derivatives history, Account statements — and columns are detected and mapped automatically.
Are there any HTX quirks I should know about?
Legacy Huobi naming still appears across some screens and docs.
My HTX import isn't working — what should I check?
Use your current HTX account — legacy Huobi naming can cause confusion.
Is my HTX data secure?
API keys are read-only and stored encrypted. TradingAtlas can never trade or withdraw from your account.
Import your HTX trades now
Connect HTX via read-only API or CSV and start tracking PnL and taxes.