API Key syncs automatically and needs no file management, recommended for most users. Use File Upload if you need pre-2022 data or want full manual control over your history.
Log in to app.koinx.com → Integrations → Add Integration.
2
Select Bybit and API Key
Search Bybit → select API Key.
3
Paste keys and import
Enter API Key + Secret Key → click Import Now.
Done. KoinX begins syncing your Bybit history. Large accounts may take a few minutes.
Once your Bybit data is in, head over to Tax Reports on KoinX - your capital gains, income breakdown, and ITR-ready Schedule VDA report are all waiting for you there.
If you used the File Upload tab above, follow these steps to complete your import. API Key users can skip this - your sync is already done.
1
Open KoinX Integrations
Log in to app.koinx.com → Integrations → Add Integration.
2
Select Bybit
Search Bybit → choose File Upload.
3
Upload all files
Select your Transaction Log + Order History files for all years. Multi-select works.
4
Submit
Click Submit - KoinX processes and imports your full history.
Done. KoinX classifies transactions and prepares them for gains calculation and report generation.
Your Bybit history is fully loaded - go to Tax Reports on KoinX and your crypto tax report is ready to download.
Never open CSV files before uploading. Re-download a fresh copy from Bybit if you already did.
KoinX Connect is a Chrome extension that automates the entire Bybit export and import process for you. It drives the Bybit export flow in the background and uploads the files (or API keys) to KoinX automatically - you only need to complete the steps Bybit requires from a logged-in human, like 2FA.
Install KoinX Connect
Add the KoinX Connect Chrome Extension before starting either method below.
Click the KoinX Connect extension icon in Chrome → select Bybit from the list of supported exchanges.
2
Choose CSV reports and set date range
Bybit offers two integration methods - CSV reports or Tax API. Select CSV reports → set your From Date and To Date → click Start CSV Export.
3
Log in to Bybit if prompted
The extension opens Bybit’s Data Export page in a new tab and checks if you’re logged in. If not, log in before proceeding. No other action is needed.
4
Wait for Bybit to generate files
Bybit typically takes 30-35 minutes to generate the CSV files. The extension waits and checks automatically in the background - you don’t need to do anything.
5
Files download and upload automatically
Once ready, the extension downloads all CSV files and uploads them to the KoinX Integrate Bybit page. The wallet is named Bybit-2 by default.
6
Review and submit
All 4 files are attached to the KoinX upload form. Review them and click Submit to finish.
Done. KoinX processes the uploaded files and syncs your Bybit transactions. The new integration appears as Bybit-2 on your Integrations page.
Behind the scenes, the extension handles both required exports for you:
Transaction Log - selects the account, all transaction types supported by KoinX, and your custom date range, then clicks Export Now.
Order History - repeats the same process on the Order History tab once the Transaction Log export is submitted.
You’ll see status messages like “STEP 1 - EXCHANGE LOGIN…”, “STEP 2 - TRADE REPORT: Submitting export 1/2…”, and “STEP 4 - KOINX UPLOAD: Looking for the file upload area…” as each stage completes.
Click the KoinX Connect extension icon in Chrome → select Bybit from the list of supported exchanges.
2
Choose Tax API
Bybit offers two integration methods - CSV reports or Tax API. Tax API is the recommended, fully automated method. Select Tax API → click Start Tax API Integration.
3
Log in to Bybit if prompted
The extension opens Bybit’s Tax API page in a new tab and checks if you’re logged in. If not, log in before proceeding.
4
Key creation begins automatically
The extension locates and clicks Create a New Tax API, with Usage set to API Transactions and Permissions set to Read-Only, then fills the API key name as KoinX.
5
Enter your Google 2FA code
This is the only manual step in the process. Open Google Authenticator, enter the 6-digit code for your Bybit account, and click Submit.
6
Confirm the API key modal
After 2FA, Bybit generates your API Key and Secret. The extension captures both automatically - the Secret is shown only once, so this happens immediately. Click Okay on Bybit’s confirmation modal if shown.
7
Log in to KoinX if prompted
The extension switches to KoinX and loads the Integrate Bybit page. If you’re not logged in, sign in - the extension waits and resumes once you’re signed in.
8
Review and submit
The extension auto-fills the Wallet Name, API Key, and Secret Key. Once everything is filled, click Import Now.
Done. KoinX shows “Fetching your transactions… Please wait.” Your Bybit account is now connected and transactions will begin syncing.
Which method should I use, API Key or File Upload?
API Key is recommended for most users. It’s faster to set up, requires no file management, and syncs automatically. Use File Upload only if you need full history control or your account has data gaps via API.
Does Bybit API sync all my transaction types?
It covers Spot, Unified Trading (Futures/Perps/Options), Earn, Fiat, and Assets. Bot trading, copy trading, and transactions older than 2 years are not available via the Bybit API.
How often does KoinX sync with Bybit via API?
KoinX fetches your Bybit data when you trigger a sync. Very recent transactions (last 3 days) may take a little longer to appear as Bybit delays them on their API end.
Can I upload multiple years of Bybit data at once?
Yes — and you should. Bybit limits each export to 12 months, so download one file per year and upload all of them together in KoinX in a single session.
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 Bybit data, select your country to generate the right report.
