> ## Documentation Index
> Fetch the complete documentation index at: https://guides.koinx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Generate Your Bybit Tax Report with KoinX

> Connect your Bybit Exchange account to KoinX in a few steps to generate tax reports compliant with your local jurisdiction.

<Info>
  **API or File Upload**  ·  **5-10 min**  ·  Spot · Futures · Earn · Fiat · Assets  ·  **100+ countries**
</Info>

## What’s covered

<CardGroup cols={2}>
  <Card title="Spot trades" color="#0066CC" icon="arrow-right-arrow-left">
    Buy, sell, and conversions.
  </Card>

  <Card title="Unified Trading" color="#0066CC" icon="chart-line">
    Futures, perpetuals, and options.
  </Card>

  <Card title="Earn and Easy Earn" color="#0066CC" icon="piggy-bank">
    Staking and savings rewards.
  </Card>

  <Card title="Fiat and Assets" color="#0066CC" icon="building-columns">
    Deposits, withdrawals, and fiat.
  </Card>
</CardGroup>

## Before you start

<CardGroup cols={2}>
  <Card title="Bybit account" icon="building-columns">
    Active account with transaction history.
  </Card>

  <Card title="KoinX account" icon="sparkles" href="https://app.koinx.com/get-started">
    Free account, no credit card needed.
  </Card>
</CardGroup>

***

## Choose how to connect Bybit to KoinX

**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.

<Tabs>
  <Tab title="API Key (Recommended)">
    ## Generate your Bybit API key

    <Steps>
      <Step title="Log in to Bybit">
        Go to [bybit.com](https://www.bybit.com) and sign in.
      </Step>

      <Step title="Open API Management">
        **Profile** → **Account** → **API** - or open [API Management](https://www.bybit.com/app/user/api-management) directly.
      </Step>

      <Step title="Create a new key">
        **Create New Key** → **System Generated API Key**.
      </Step>

      <Step title="Configure the key">
        | Setting           | Value                                          |
        | ----------------- | ---------------------------------------------- |
        | API Key Usage     | `API Transaction`                              |
        | API Key Name      | e.g. `KoinX Taxation`                          |
        | Permissions       | `Read Only`                                    |
        | IP Restriction    | `No IP Restriction`                            |
        | Trade permissions | Unified Trading · Earn · Fiat Trading · Assets |

        <Warning>
          Use **Read Only** and set IP Restriction to **No IP Restriction** to avoid connection failures.
        </Warning>
      </Step>

      <Step title="Copy your keys">
        Click **Submit**, complete verification, copy your **API Key** and **Secret Key**.
      </Step>
    </Steps>

    ## Connect Bybit to KoinX

    <Steps>
      <Step title="Open KoinX Integrations">
        Log in to [app.koinx.com](https://app.koinx.com) → **Integrations** → **Add Integration**.
      </Step>

      <Step title="Select Bybit and API Key">
        Search **Bybit** → select **API Key**.
      </Step>

      <Step title="Paste keys and import">
        Enter **API Key** + **Secret Key** → click **Import Now**.
      </Step>
    </Steps>

    <Check>
      **Done.** KoinX begins syncing your Bybit history. Large accounts may take a few minutes.
    </Check>

    Once your Bybit data is in, head over to [Tax Reports](https://app.koinx.com/tax-report) on KoinX - your capital gains, income breakdown, and ITR-ready Schedule VDA report are all waiting for you there.

    ## API key notes

    <Note>
      * **Keys expire every 3 months** - regenerate and reconnect when this happens.
      * **Last 3 days may lag** - Bybit delays very recent transactions before exposing them via API.
      * **Some past conversion trades** may not appear - this is a Bybit API limitation.
    </Note>
  </Tab>

  <Tab title="File Upload">
    <Warning>
      * **Max 12 months per export** - download year-wise, upload all files together.
      * **Exports take 1-3 days** to appear in My Export. Plan ahead.
      * **Data before 2022** is not available via self-export. Email [support@bybit.com](mailto:support@bybit.com).
    </Warning>

    Log in to Bybit → **Profile** → **Account** → **Data Export** - or open [Data Export](https://www.bybit.com/user/assets/exportList) directly.

    <Tabs>
      <Tab title="Transaction Log">
        <Steps>
          <Step title="Open Data Export">
            Go to **Profile** → **Account** → **Data Export** — or open [Data Export](https://www.bybit.com/user/assets/exportList) directly — and click the **Transaction Log** tab.
          </Step>

          <Step title="Select account and type">
            Set **Account** to `Main Account` and **Type** to `Account Change Details` + `Funding Records`.
          </Step>

          <Step title="Set date range">
            Under **Time**, choose **Customize** and enter a 12-month range (e.g. `1 Jan 2023 – 31 Dec 2023`). One year maximum per file.
          </Step>

          <Step title="Export and download">
            Click **Export** → wait for the file to appear under **My Export** (up to 3 days) → download it. Repeat for each year.
          </Step>
        </Steps>

        <Note>
          Also download your Order History — switch to the Order History tab to continue.
        </Note>
      </Tab>

      <Tab title="Order History">
        <Steps>
          <Step title="Open Data Export">
            Go to **Profile** → **Account** → **Data Export** — or open [Data Export](https://www.bybit.com/user/assets/exportList) directly — and click the **Order History** tab.
          </Step>

          <Step title="Select account and product types">
            Set **Account** to `Main Account` and select all product types: `Unified Trading`, `Trading Tools`, `Lending`, `Easy Earn`.

            <Tip>
              Select all product types — missing one means that activity won't appear in KoinX.
            </Tip>
          </Step>

          <Step title="Set date range">
            Under **Time**, choose **Customize** and enter a 12-month range (e.g. `1 Jan 2023 – 31 Dec 2023`). One year maximum per file.
          </Step>

          <Step title="Export and download">
            Click **Export** → wait for the file to appear under **My Export** (up to 3 days) → download it. Repeat for each year.
          </Step>
        </Steps>

        <Note>
          Both files downloaded — scroll down to the Upload to KoinX section to complete your import.
        </Note>
      </Tab>
    </Tabs>

    ## Upload to KoinX

    <Note>
      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.
    </Note>

    <Steps>
      <Step title="Open KoinX Integrations">
        Log in to [app.koinx.com](https://app.koinx.com) → **Integrations** → **Add Integration**.
      </Step>

      <Step title="Select Bybit">
        Search **Bybit** → choose **File Upload**.
      </Step>

      <Step title="Upload all files">
        Select your Transaction Log + Order History files for all years. Multi-select works.
      </Step>

      <Step title="Submit">
        Click **Submit** - KoinX processes and imports your full history.
      </Step>
    </Steps>

    <Check>
      **Done.** KoinX classifies transactions and prepares them for gains calculation and report generation.
    </Check>

    Your Bybit history is fully loaded - go to [Tax Reports](https://app.koinx.com/tax-report) on KoinX and your crypto tax report is ready to download.

    <Warning>
      **Never open CSV files before uploading.** Re-download a fresh copy from Bybit if you already did.
    </Warning>
  </Tab>
</Tabs>

***

## Frequently asked questions

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="API key error on connection">
    Check your key in [Bybit API Management](https://www.bybit.com/app/user/api-management). Keys expire every 3 months — generate a new one and reconnect to KoinX.
  </Accordion>

  <Accordion title="Sync is taking too long">
    Bybit rate limits mean large accounts can take minutes to hours. Wait before refreshing or re-triggering the sync.
  </Accordion>

  <Accordion title="Bot or copy trading transactions missing">
    These are not supported by the Bybit API and cannot be imported via any API key method.
  </Accordion>

  <Accordion title="Export not visible in My Export yet">
    Bybit takes 1–3 days to generate export files. Wait and check back before re-exporting.
  </Accordion>

  <Accordion title="Trades missing after file upload">
    Ensure both Transaction Log **and** Order History were uploaded for every year. Any missing file leaves gaps in your import.
  </Accordion>

  <Accordion title="Upload error in KoinX">
    Re-download the original CSV files without opening them. Opening in Excel or Google Sheets corrupts the file format.
  </Accordion>

  <Accordion title="Pre-2022 trades missing">
    Neither API nor file export covers pre-2022 data. Email [**support@bybit.com**](mailto:support@bybit.com) to request historical data.
  </Accordion>
</AccordionGroup>

***

## Related integrations

<CardGroup cols={2}>
  <Card title="Binance - File Upload" icon="chart-bar" href="/integration/binance">
    Export Binance CSVs and import into KoinX.
  </Card>

  <Card title="Bitget - API Upload" icon="key" href="/integration/bitget">
    Connect Bitget via Tax API Key or Normal API Key.
  </Card>

  <Card title="CoinDCX — Direct Connect" icon="mobile" href="/integration/coindcx">
    Connect CoinDCX directly from the app in 4 taps.
  </Card>

  <Card title="KuCoin Integration" icon="chart-line" href="/integration/kucoin">
    Sync KuCoin trades via API or file upload.
  </Card>
</CardGroup>

<Card title="Ready to generate your Bybit crypto tax report?" color="#6366f1" icon="rocket" href="https://app.koinx.com/get-started">
  Create a free KoinX account, no credit card required. Import your Bybit transactions and generate a country-specific tax report in minutes.
</Card>