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

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

<Info>
  **API**  ·  **5-10 min**  ·  Spot · 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="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>

  <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="BTC-Alpha 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 BTC-Alpha to KoinX

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

<Tabs>
  <Tab title="API Key">
    ## Generate your BTC-Alpha API key

    <Steps>
      <Step title="Log in to BTC-Alpha">
        Go to [btc-alpha.com](https://www.btc-alpha.com) and sign in to your account.
      </Step>

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

      <Step title="Select Read Only and create the key">
        In the API section, ensure **Read Only** is selected and click **Create API**.

        <Warning>
          Select **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 BTC-Alpha 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 BTC-Alpha">
        Search for **BTC-Alpha** 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 BTC-Alpha history. Large accounts may take a few minutes.
    </Check>

    Once your BTC-Alpha 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.
      * **Secret Key is shown once only** - copy it immediately at the time of creation and store it securely.
      * **Sync from account creation date** - transaction history must cover the full period from when you opened your BTC-Alpha account with no gaps.
    </Note>
  </Tab>
</Tabs>

***

## Frequently asked questions

<AccordionGroup>
  <Accordion title="What permissions does the BTC-Alpha 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 BTC-Alpha show my Secret Key again after I leave the page?">
    No. BTC-Alpha displays the Secret Key only once at the time of creation. Copy it immediately and store it securely. If lost, delete the key from the API section in your profile and generate a new one.
  </Accordion>

  <Accordion title="Do I need to report my BTC-Alpha transactions for tax purposes?">
    Yes. Cryptocurrency transactions including those on BTC-Alpha are taxed according to the law in your jurisdiction. You are responsible for correctly disclosing your crypto activity to the relevant tax authority in your region.
  </Accordion>

  <Accordion title="Does BTC-Alpha provide tax reports directly?">
    No. BTC-Alpha does not provide tax-ready reports for direct filing. By connecting your BTC-Alpha 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 BTC-Alpha data, select your country to generate the correct report.
  </Accordion>
</AccordionGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="API key error on connection">
    Confirm Read Only is selected in **BTC-Alpha** -> **Profile** -> **API**. Delete the credentials in KoinX and re-enter both values carefully - copy directly from BTC-Alpha to avoid invisible characters.
  </Accordion>

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

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

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

  <Accordion title="Wrong permissions were selected during API creation">
    Delete the existing key from **BTC-Alpha** -> **Profile** -> **API**, generate a new key with Read Only permission only, and reconnect in KoinX with the new credentials.
  </Accordion>

  <Accordion title="KoinX is showing duplicate BTC-Alpha transactions">
    Check **KoinX** -> **Integrations** for duplicate BTC-Alpha 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 BTC-Alpha 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 BTC-Alpha transactions and generate a country-specific tax report in minutes.
</Card>