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

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

<Info>
  **API**  ·  **5-10 min**  ·  Spot · Perpetual · Staking · 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="Perpetual futures" color="#0066CC" icon="chart-line">
    Perpetual trading positions and history.
  </Card>

  <Card title="Staking and Rewards" color="#0066CC" icon="piggy-bank">
    Staking income and reward distributions.
  </Card>

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

## Before you start

<CardGroup cols={2}>
  <Card title="BitForex 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>

***

## Connect BitForex to KoinX

**API Key syncs your full BitForex transaction history automatically - no file exports needed.**

<Tabs>
  <Tab title="API Key">
    ## Generate your BitForex API key

    <Steps>
      <Step title="Log in to BitForex">
        Go to [bitforex.com](https://www.bitforex.com) and sign in to your account.
      </Step>

      <Step title="Open API Management">
        Click the **profile icon** in the top right corner and select **API Management**.
      </Step>

      <Step title="Create a new API key">
        Click **Create API Key**.
      </Step>

      <Step title="Name your key and set read-only permissions">
        Enter a label for your key (e.g. `KoinX`) and ensure read-only permissions are selected.

        <Warning>
          Enable read-only permissions only. Never enable trading or withdrawal permissions on an API key connected to a third-party service.
        </Warning>
      </Step>

      <Step title="Copy your API key and Secret Key">
        Copy both your **API Key** and **Secret Key** and store them securely. The Secret Key is shown only once.
      </Step>
    </Steps>

    ## Connect BitForex 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 BitForex">
        Search for **BitForex** and select it.
      </Step>

      <Step title="Paste your keys and import">
        Paste your **API Key** and **Secret Key** into the respective fields and click **Import Now**.
      </Step>
    </Steps>

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

    Once your BitForex 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.

    ## API key notes

    <Note>
      * **Read Only is required** - keys with broader permissions may be rejected by KoinX as a security measure.
      * **Label the key as KoinX** - naming the API key "KoinX" in BitForex helps identify which service is using it and avoids confusion when managing multiple keys.
      * **Use Sync Now** to pull the latest BitForex transactions into KoinX at any time from the Integrations panel.
    </Note>
  </Tab>
</Tabs>

***

## Frequently asked questions

<AccordionGroup>
  <Accordion title="What permissions does the BitForex API key need for KoinX?">
    Read Only permissions only. This gives KoinX access to your full transaction history without the ability to place trades or move funds. Never generate an API key with broader permissions for a third-party service.
  </Accordion>

  <Accordion title="Will BitForex show my Secret Key again after I leave the page?">
    No. BitForex displays the Secret Key only once at the time of creation. Copy it immediately and store it securely. If lost, delete the key from API Management and generate a new one.
  </Accordion>

  <Accordion title="Do I need to report my BitForex transactions for tax purposes?">
    Yes. Reporting your BitForex transactions for tax purposes is vital for compliance with tax regulations. Not reporting can invite audits on your portfolio and lead to penalties from the relevant authority in your region.
  </Accordion>

  <Accordion title="Does BitForex provide tax reports directly?">
    No. BitForex does not provide tax-ready reports. By connecting your BitForex account to KoinX via API key, your full transaction history is imported automatically and a compliant, country-specific tax report is generated within minutes.
  </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 BitForex data, select your country to generate the correct report.
  </Accordion>
</AccordionGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="API key error on connection">
    Confirm the key was generated with read-only permissions in **BitForex** -> **Profile** -> **API Management**. Delete the credentials in KoinX and re-enter both values carefully - copy directly from BitForex to avoid invisible characters.
  </Accordion>

  <Accordion title="Transactions are missing after sync">
    Ensure the full transaction history from your BitForex account creation date is included with no gaps. Trigger a manual re-sync from **KoinX** -> **Integrations** -> **BitForex**. If records are still missing, disconnect and reconnect with a fresh API key.
  </Accordion>

  <Accordion title="API sync keeps failing">
    Check the BitForex platform for ongoing maintenance. If the platform is operational, verify the key is still active under **API Management**. Regenerate if expired, re-enter credentials in KoinX, and trigger a fresh sync.
  </Accordion>

  <Accordion title="API connection worked before but stopped syncing">
    BitForex API keys can become inactive following account security changes. Log in to BitForex, check the key status under **API Management**, and regenerate if inactive. Update the new credentials in KoinX under **Integrations** -> **BitForex** -> **Edit**.
  </Accordion>

  <Accordion title="Perpetual futures or staking rewards are missing from KoinX">
    Confirm read-only permissions on the key include access to all account and product types. If trades are still missing after re-syncing, generate a new API key and reconnect in KoinX.
  </Accordion>

  <Accordion title="KoinX is showing duplicate BitForex transactions">
    Check **KoinX** -> **Integrations** for duplicate BitForex connections and remove any extras. If a file was previously uploaded for the same period, delete those transactions before re-syncing via API.
  </Accordion>
</AccordionGroup>

***

## Related integrations

<CardGroup cols={2}>
  <Card title="Bybit Integration" icon="bolt" href="/integration/bybit">
    Connect Bybit via API key or file upload.
  </Card>

  <Card title="Binance - File Upload" icon="chart-bar" href="/integration/binance">
    Export Binance CSVs for Spot, P2P, Earn, and Options.
  </Card>

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

  <Card title="OKX Integration" icon="chart-line" href="/integration/okx">
    Sync OKX trades and earn history via API or CSV.
  </Card>
</CardGroup>

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