> ## 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 BitBns Tax Report with KoinX

> Connect your BitBns account to KoinX in a few steps to generate and file your BitBns taxes accurately. Tracks Section 194S TDS and generates an ITD-compliant Schedule VDA report.

<Info>
  **Direct Connect or File Upload**  ·  **5-10 min**  ·  Spot · Bitdroplet · Deposits · Withdrawals  ·  **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="Bitdroplet transactions" color="#0066CC" icon="chart-line">
    Margin, P2P, and Bitdroplet trade history.
  </Card>

  <Card title="Deposits and Withdrawals" color="#0066CC" icon="building-columns">
    On-chain deposits and withdrawals.
  </Card>

  <Card title="Trading Fees and Rebates" color="#0066CC" icon="receipt">
    Fee records and trading rebates.
  </Card>
</CardGroup>

## Before you start

<CardGroup cols={2}>
  <Card title="BitBns account" icon="building-columns">
    Active account with transaction history, accessible via web browser.
  </Card>

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

***

## Connect BitBns to KoinX

**Direct Connect links your BitBns account to KoinX instantly via OAuth - recommended for most users.** Use File Upload if you want manual control over your transaction history or need to import older data. Use KoinX Connect if you'd like a guided, automated browser extension to extract and upload your reports for you.

<Tabs>
  <Tab title="Direct Connect (Recommended)">
    ## Connect BitBns directly 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 BitBns">
        Search for **BitBns** and select it.
      </Step>

      <Step title="Click Connect BitBns">
        Click the **Connect BitBns** button. You will be redirected to the BitBns OAuth page.
      </Step>

      <Step title="Allow the integration">
        Click **Allow** on the BitBns OAuth page to grant KoinX access to your account.
      </Step>
    </Steps>

    <Check>
      **Done.** You will be redirected back to KoinX. All your BitBns transactions will appear within a couple of seconds.
    </Check>

    Once your BitBns data is in, head over to [Tax Reports](https://app.koinx.com/tax-report) on KoinX - your capital gains, income breakdown, and country-specific crypto tax report are ready for you there.

    ## Direct Connect notes

    <Note>
      * **OAuth is secure** - KoinX connects via BitBns's official authorisation flow and never accesses your login credentials.
      * **Real-time syncing** - KoinX fetches new BitBns transactions each time you trigger a sync from the Integrations panel.
    </Note>
  </Tab>

  <Tab title="File Upload">
    Export both CSV report types from your BitBns account. Both files are required for a complete transaction history - Trade History covers spot trades and Bitdroplet covers margin and P2P activity.

    <Tabs>
      <Tab title="Trade History">
        <Steps>
          <Step title="Log in to BitBns on web">
            Go to [bitbns.com](https://www.bitbns.com) and sign in. File upload requires the web version.
          </Step>

          <Step title="Go to Trade History">
            Click **Orders** in the top menu bar -> **Trade History** -> **Trade Reports** on the left side.
          </Step>

          <Step title="Set date range and mail report">
            Set the date range (maximum 1 year, e.g. 1 Jan 2024 to 31 Dec 2024) and click **Mail Report**. The CSV will be sent to your registered email address.

            <Note>
              Also download your Bitdroplet Transaction report - switch to the Bitdroplet Transaction tab to continue.
            </Note>
          </Step>
        </Steps>
      </Tab>

      <Tab title="Bitdroplet Transaction">
        <Steps>
          <Step title="Go to Bitdroplet Transaction">
            On the same Trade Reports page, select **Bitdroplet Transaction** from the left side.
          </Step>

          <Step title="Set date range and mail report">
            Set the same date range as your Trade History export (maximum 1 year) and click **Mail Report**. The second CSV will be sent to your registered email address.

            <Warning>
              Both files are required. The Bitdroplet Transaction report is essential for capturing margin and P2P trades. Uploading only the Trade History file will result in missing transactions.
            </Warning>
          </Step>

          <Step title="Download both files from email">
            Check your registered email inbox for both CSV files. Check your Spam or Junk folder if they have not arrived. Do not open the files before uploading.
          </Step>
        </Steps>

        <Note>
          Both files downloaded - scroll down to the Upload to KoinX section to import everything at once.
        </Note>
      </Tab>
    </Tabs>

    ## Upload to KoinX

    <Note>
      If you used the **File Upload** tab above, follow these steps to complete your import. Direct Connect 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 BitBns">
        Search for **BitBns** and select it.
      </Step>

      <Step title="Upload both files">
        Click **Upload** and select both your BitBns CSV files - Trade History and Bitdroplet Transaction. Multi-select works.
      </Step>

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

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

    Now that your BitBns files are in, head to [Tax Reports](https://app.koinx.com/tax-report) on KoinX - your capital gains across spot trades, Bitdroplet activity, and withdrawals are already calculated and your report is ready to download.

    <Warning>
      **Never open or edit the BitBns CSV files before uploading.** This corrupts the file format. If you already did - re-request fresh reports from BitBns and upload those instead.
    </Warning>
  </Tab>

  <Tab title="KoinX Connect">
    **KoinX Connect is a Chrome extension that automates the entire report extraction and upload process for you** - it logs into BitBns, requests your report, watches Gmail for it, downloads it, and uploads it to KoinX, with just one click required from you at the end.

    ## Quick steps:

    <Steps>
      <Step title="Open KoinX Connect and select BitBns">
        Open the KoinX Connect extension -> Select **BitBns**.
      </Step>

      <Step title="Set date range and start extraction">
        Set your date range -> Click **Start Extraction**.
      </Step>

      <Step title="Log in to BitBns if prompted">
        Log in to BitBns if prompted.
      </Step>

      <Step title="Wait for the email">
        Wait \~15 minutes for BitBns to email your report - the system watches Gmail automatically.
      </Step>

      <Step title="Automatic download and upload">
        The system downloads the file from Gmail and uploads it to KoinX.
      </Step>

      <Step title="Review and submit">
        Review the uploaded files -> Click **Submit** -> Done!
      </Step>
    </Steps>

    ## Before you begin

    <CardGroup cols={2}>
      <Card title="KoinX Connect extension" icon="puzzle-piece">
        Chrome extension installed. [Install here](https://app.koinx.com/get-started)
      </Card>

      <Card title="BitBns account" icon="building-columns">
        Logged in on your browser.
      </Card>

      <Card title="KoinX account" icon="sparkles">
        Logged in, or ready to log in.
      </Card>

      <Card title="Gmail account" icon="envelope">
        The Gmail account linked to your BitBns account, accessible in the same browser.
      </Card>
    </CardGroup>

    ## Detailed step-by-step guide

    <Steps>
      <Step title="Select BitBns from KoinX Connect">
        Click the KoinX Connect extension icon in Chrome. A Connect panel opens listing supported exchanges.

        **Action:** Click on BitBns from the list.
      </Step>

      <Step title="Set date range and start extraction">
        The BitBns Report Extraction panel opens. The extension pre-fills your current financial year dates, but you can adjust them. The report will be emailed and automatically imported into KoinX.

        **Action:** Set your From Date and To Date -> Click "Start Extraction"
      </Step>

      <Step title="BitBns login check (system)">
        The system automatically opens BitBns in a new tab and checks if you're logged in. If not, it pauses and waits for you to log in.

        **Action:** Log in to BitBns if prompted. No other action needed.

        <Info>
          KoinX Extension Message: *"STEP 1 — EXCHANGE LOGIN: Not logged in. Please log in to BitBns to continue."* -> Once logged in: *"Logged in! Navigating to Trade Report page..."*
        </Info>
      </Step>

      <Step title="Trade Report page opens (system)">
        The system automatically navigates to the Trade Report section inside your BitBns profile.

        **Action:** None. System handles this automatically.

        <Info>
          KoinX Extension Message: *"STEP 2 — TRADE REPORT: Loading Trade Report page..."*
        </Info>
      </Step>

      <Step title="Date range is filled and report requested (system)">
        The system automatically selects Trade History and fills in your date range, then clicks Mail Report. BitBns confirms with a green notification: "Request successful, your report would be sent in 15 minutes."

        **Action:** None. System handles this automatically.

        <Info>
          KoinX Extension Message: *"Filling date range..."* -> *"Clicking 'Mail Report'..."* -> *"Report requested! Opening Gmail to wait for the email..."*
        </Info>
      </Step>

      <Step title="Gmail is opened and monitored (system)">
        The system automatically opens Gmail and searches for the BitBns trade report email. It waits for the email to arrive - this can take up to 15 minutes.

        **Action:** None. Just wait. Do not close the Gmail tab.

        <Info>
          KoinX Extension Message: *"STEP 3 — GMAIL: Navigating to Gmail search..."* -> *"Waiting for BitBNS report email (this may take a minute)..."*
        </Info>
      </Step>

      <Step title="Report email is detected and file downloaded (system)">
        Once the BitBns report email arrives in Gmail, the system opens it, expands the conversation, waits for it to fully render, and downloads the report file.

        **Action:** None. System handles this automatically.

        <Info>
          KoinX Extension Message: *"Waiting for attachments to load..."* -> *"Expanding conversation (all messages)..."* -> *"Waiting for Gmail to finish rendering..."* -> *"Report downloaded! Opening KoinX..."*
        </Info>
      </Step>

      <Step title="Files are uploaded to KoinX (system)">
        The system automatically opens the KoinX Integrate BitBns page and uploads all downloaded report files. The wallet is named BitBNS-1 by default.

        **Action:** None. System handles this automatically.

        <Info>
          KoinX Extension Message: *"STEP 4 — KOINX UPLOAD: Looking for the file upload area..."* -> *"Uploading file(s) to KoinX..."* Once done: *"Done! 4 file(s) uploaded to KoinX."*
        </Info>
      </Step>

      <Step title="Review and submit (final action)">
        All report files are now attached to the KoinX upload form. Review the files listed on screen.

        **Action:** Click "Submit"
      </Step>
    </Steps>

    <Check>
      **Integration complete.** KoinX will process the uploaded files and sync your BitBns transactions. The integration will appear as BitBNS-1 on your Integrations page.
    </Check>

    ## Important alerts

    <Warning>
      * BitBns reports are emailed - the system automatically monitors your Gmail and downloads the file once it arrives.
      * Report generation typically takes up to 15 minutes - the system waits automatically.
      * Keep the browser open and do not close any tabs while the system is working.
      * If you have trades in BitDroplet, you will need to upload your BitDroplet transaction history separately - this is not included in the Trade History report.
    </Warning>

    ## What the system does vs. what you do

    | Action                                     | Who Does It        |
    | ------------------------------------------ | ------------------ |
    | Opening BitBns Trade Report page           | ✅ System           |
    | Selecting Trade History report type        | ✅ System           |
    | Filling date range                         | ✅ System           |
    | Clicking Mail Report                       | ✅ System           |
    | Opening Gmail and waiting for report email | ✅ System           |
    | Downloading report file from Gmail         | ✅ System           |
    | Uploading files to KoinX                   | ✅ System           |
    | Clicking Submit                            | 👤 You (one click) |
  </Tab>
</Tabs>

***

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Which method should I use - Direct Connect or File Upload?">
    Direct Connect is recommended for most users. It links instantly via OAuth, requires no file management, and syncs automatically. Use File Upload if you need to import a specific date range manually or if Direct Connect is unavailable.
  </Accordion>

  <Accordion title="Do I need to upload both CSV files for File Upload?">
    Yes. Both the Trade History CSV and the Bitdroplet Transaction CSV are required. The Bitdroplet file covers margin and P2P trades that are not included in the standard Trade History export. Uploading only one file will result in missing transactions.
  </Accordion>

  <Accordion title="Why is each BitBns export limited to 1 year?">
    BitBns restricts each CSV export to a maximum date range of 1 year. If your history spans multiple years, export one file per year for each report type and upload all files together in one KoinX session.
  </Accordion>

  <Accordion title="Where will BitBns send the CSV files?">
    BitBns sends the CSV files to your registered email address after you click Mail Report. Check your Spam or Junk folder if the email has not arrived within 30 minutes. You can request a resend from the same page if needed.
  </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 BitBns data, select your country to generate the correct report.
  </Accordion>

  <Accordion title="What is KoinX Connect and how is it different from File Upload?">
    KoinX Connect is a Chrome extension that automates the File Upload process end-to-end. Instead of manually exporting CSVs and uploading them yourself, the extension logs into BitBns, requests the report, monitors your Gmail, downloads the file, and uploads it to KoinX - you only need to click Submit at the end.
  </Accordion>
</AccordionGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Direct Connect is not redirecting back to KoinX">
    Ensure you clicked **Allow** on the BitBns OAuth page. If the redirect failed, clear your browser cache, log in to BitBns directly, and retry the connection from **KoinX** -> **Integrations** -> **BitBns** -> **Direct Connect**.
  </Accordion>

  <Accordion title="CSV email has not arrived">
    Verify your registered email address is correct in your BitBns profile. Check your Spam or Junk folder. If the email has not arrived after 30 minutes, return to the Trade Reports page and click Mail Report again.
  </Accordion>

  <Accordion title="Transactions are missing after CSV upload">
    Confirm both the Trade History and Bitdroplet Transaction files were uploaded. If records from specific years are missing, export a separate file for each year and upload all files together in one KoinX session.
  </Accordion>

  <Accordion title="Bitdroplet trades are missing from KoinX">
    The Bitdroplet Transaction CSV must be uploaded alongside the Trade History file. Go to **BitBns** -> **Orders** -> **Trade History** -> **Bitdroplet Transaction**, export the file, and re-upload both files together in KoinX.
  </Accordion>

  <Accordion title="CSV file won't upload to KoinX">
    Upload the original CSV files received from BitBns via email without opening or editing them. Opening files in Excel or Google Sheets reformats the structure and causes upload errors in KoinX.
  </Accordion>

  <Accordion title="KoinX is showing duplicate BitBns transactions">
    Check **KoinX** -> **Integrations** for duplicate BitBns connections and remove any extras. If both a Direct Connect sync and a CSV upload were done for the same period, remove one and retain only a single connection method.
  </Accordion>

  <Accordion title="KoinX Connect is stuck waiting for the Gmail report">
    Do not close the Gmail tab while the extension is working. Report generation can take up to 15 minutes. Check your Spam or Junk folder for the BitBns email, and confirm the Gmail account open in the browser is the one linked to your BitBns account.
  </Accordion>
</AccordionGroup>

***

## Related integrations

<CardGroup cols={2}>
  <Card title="CoinDCX - Direct Connect" icon="mobile" href="/integration/coindcx">
    Connect CoinDCX directly from the app in 4 taps.
  </Card>

  <Card title="CoinSwitch Integration" icon="file-arrow-up" href="/integration/coinswitch">
    Import CoinSwitch trades via account statement.
  </Card>

  <Card title="WazirX Integration" icon="arrow-right-arrow-left" href="/integration/wazirx">
    Import WazirX trades via file upload.
  </Card>

  <Card title="Mudrex Integration" icon="chart-line" href="/integration/mudrex">
    Connect Mudrex via Direct Integration or XLSX Upload.
  </Card>
</CardGroup>

<Card title="Ready to generate your BitBns 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 BitBns transactions and generate a country-specific tax report in minutes.
</Card>