API or File Upload · 5-10 min · Spot · Derivatives · Deposits · Withdrawals · 100+ countries
What’s covered
Spot trades
Buy, sell, and conversions.
Derivatives and Positions
Derivatives positions and settlements.
Deposits and Withdrawals
On-chain deposits and withdrawals.
Trading Fees and Rebates
Fee records and trading rebates.
Before you start
Bitunix account
Active account with transaction history, accessed via web browser.
KoinX account
Free account - no credit card needed.
Connect Bitunix to KoinX
API Key syncs automatically and needs no file management - recommended for most users. Use File Upload if you want manual control over your transaction history.- API Key (Recommended)
- File Upload
Generate your Bitunix API key
Log in to Bitunix
Go to bitunix.com and sign in to your account.
Open API Management
Click the profile icon in the top right corner, select API from the menu, then click API Management.
Fill in the API details
Enter the following details:
| Field | Value |
|---|---|
| Name | KoinX (so you can identify it later) |
| Purpose | Bind Third-Party App |
| Permissions | Read Only (keep the default) |
Complete security verification
Complete the security verification using your linked authentication method and click Submit.
Connect Bitunix to KoinX
Open KoinX Integrations
Log in to app.koinx.com -> Integrations -> Add Integration.
Paste your keys and set start date
Paste your API Key and Secret Key into the respective fields. Optionally set a start date to specify from which point your transactions should be imported.
Done. KoinX begins syncing your Bitunix history. Large accounts may take a few minutes.
API key notes
- Purpose must be set to Bind Third-Party App - this is the correct purpose for connecting Bitunix to KoinX.
- Read Only is required - keys with broader permissions may be rejected by KoinX as a security measure.
- Secret Key is shown once only - copy it immediately at the time of creation and store it securely.
Frequently asked questions
Which method should I use - API Key or File Upload?
Which method should I use - API Key or File Upload?
API Key is recommended for most users. It connects automatically, requires no file management, and syncs your full history when you set the start date correctly. Use File Upload if you want manual control over which date range is imported.
What permissions does the Bitunix API key need for KoinX?
What permissions does the Bitunix API key need for KoinX?
Read Only permissions with the purpose set to Bind Third-Party App. This gives KoinX access to your full transaction history without the ability to place trades or move funds.
What date range should I select for the Bitunix CSV export?
What date range should I select for the Bitunix CSV export?
Select a date range that covers your entire Bitunix trading history. If you have traded across multiple years, export each year as a separate file and upload all files together in one KoinX session.
Will Bitunix show my Secret Key again after I leave the page?
Will Bitunix show my Secret Key again after I leave the page?
No. Bitunix displays the Secret Key only once after submission. Copy it immediately and store it securely. If lost, delete the key from API Management and generate a new one.
Does KoinX support my country's crypto tax rules?
Does KoinX support my country's crypto tax rules?
Yes. KoinX supports 100+ countries with dedicated report formats for India, the US, UK, Australia, Canada, Germany, and more. After importing your Bitunix data, select your country to generate the correct report.
Troubleshooting
API key error on connection
API key error on connection
Confirm Read Only permissions and Bind Third-Party App purpose are set in Bitunix -> Profile -> API -> API Management. Delete the credentials in KoinX and re-enter both values carefully - copy directly from Bitunix to avoid invisible characters.
CSV file won't upload to KoinX
CSV file won't upload to KoinX
Re-generate a fresh CSV from the Bitunix Tax Report page without opening it. Opening the file in Excel or Google Sheets reformats the structure and breaks the upload.
Transactions are missing after sync or upload
Transactions are missing after sync or upload
For API: ensure the start date in KoinX covers your first Bitunix trade. For File Upload: confirm the date range covers your full history and all years were exported and uploaded. Trigger a manual re-sync from KoinX -> Integrations -> Bitunix.
API sync keeps failing
API sync keeps failing
Check the Bitunix platform for ongoing maintenance. If operational, verify the key is still active under API Management. Regenerate if expired or revoked, re-enter credentials in KoinX, and trigger a fresh sync.
Large trading history is taking a long time to sync
Large trading history is taking a long time to sync
Large trading histories may take extra time to fully sync. Allow the process to complete before reviewing your transactions. Avoid re-triggering the sync while it is still in progress.
KoinX is showing duplicate Bitunix transactions
KoinX is showing duplicate Bitunix transactions
Check KoinX -> Integrations for duplicate Bitunix connections and remove any extras. If both an API sync and a CSV upload were done for the same period, remove one and retain only a single connection method.
Related integrations
Bybit Integration
Connect Bybit via API key or file upload.
Binance - File Upload
Export Binance CSVs for Spot, P2P, Earn, and Options.
Bitget - API Upload
Connect Bitget via Tax API Key or Normal API Key.
OKX Integration
Sync OKX trades and earn history via API or CSV.
Ready to generate your Bitunix crypto tax report?
Create a free KoinX account - no credit card required. Import your Bitunix transactions and generate a country-specific tax report in minutes.