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

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

<Info>
  **API Key**  ·  **\~5 min**  ·  Spot · Deposits · Withdrawals  ·  **Australia + 100+ countries**
</Info>

## What's covered

<CardGroup cols={2}>
  <Card title="Spot trades" color="#0066CC" icon="arrow-right-arrow-left">
    All buy and sell orders synced automatically.
  </Card>

  <Card title="Deposits and Withdrawals" color="#0066CC" icon="building-columns">
    Full funding history included.
  </Card>
</CardGroup>

## Before you start

<CardGroup cols={2}>
  <Card title="BTC Markets account" icon="building-columns">
    Active account at [btcmarkets.net](https://www.btcmarkets.net) 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>

***

## Generate your BTC Markets API key

<Steps>
  <Step title="Log in to BTC Markets">
    Go to [btcmarkets.net](https://www.btcmarkets.net) and sign in to your account.
  </Step>

  <Step title="Open API Key management">
    Go to the **Account** section from the main menu → select **API Key** → click **Add New API Key**.
  </Step>

  <Step title="Name and configure your key">
    Enter a name for your API key (e.g. `KoinX Tax Reporting`) and set the access permissions:

    | Setting    | Value       |
    | ---------- | ----------- |
    | Permission | `Read Only` |

    <Warning>
      **Always select Read Only.** Never enable Read & Write — KoinX only needs to read your transaction data.
    </Warning>
  </Step>

  <Step title="Submit and verify">
    Review the details and click **Submit**. Enter your **password or 2FA code** to authorise the key creation.
  </Step>

  <Step title="Copy your Secret Key immediately">
    Your **Secret Key** will appear on screen. **Copy and store it somewhere safe right now.**

    <Warning>
      **The Secret Key is shown only once and cannot be retrieved again.** If you lose it, you must delete the key and create a new one.
    </Warning>
  </Step>

  <Step title="Note your Public API Key">
    Your **Public API Key** is also accessible from the same screen. Copy it alongside the Secret Key.
  </Step>
</Steps>

***

## Connect BTC Markets to KoinX

<Steps>
  <Step title="Log in to KoinX">
    Go to [app.koinx.com](https://app.koinx.com) and sign in.
  </Step>

  <Step title="Open BTC Markets Integration">
    Click **Integrations** → **Add Integration** → search for and select **BTC Markets**.
  </Step>

  <Step title="Enter your API keys">
    Paste your **Public API Key** and **Secret Key** into the respective fields.
  </Step>

  <Step title="Click Connect">
    Click **Connect**. KoinX will start syncing your BTC Markets transaction history.
  </Step>
</Steps>

<Check>
  **Done.** KoinX syncs your BTC Markets trades, deposits, and withdrawals and prepares everything for gains calculation and tax report generation.
</Check>

BTC Markets is synced and all your trades are in — go to [Tax Reports](https://app.koinx.com/tax-report) on KoinX and your Australian CGT report is calculated and ready to review or send to your accountant.

***

## Frequently asked questions

<AccordionGroup>
  <Accordion title="What happens if I lose my Secret Key?">
    The Secret Key is shown **only once** at creation. If lost, go to BTC Markets → Account → API Key, delete the existing key, and create a new one. Copy the new Secret Key immediately.
  </Accordion>

  <Accordion title="Why must I select Read Only permission?">
    KoinX only reads your transaction history — it never places trades or moves funds. Read Only ensures KoinX has exactly the access it needs and nothing more.
  </Accordion>

  <Accordion title="What is the difference between Public API Key and Secret Key?">
    The **Public API Key** identifies your integration and can be viewed again from the BTC Markets API Key screen. The **Secret Key** authenticates requests and is shown only once — treat it like a password.
  </Accordion>

  <Accordion title="Does KoinX support Australian crypto tax reporting from BTC Markets?">
    Yes. KoinX supports Australian CGT rules and generates ATO-compatible tax reports from BTC Markets data. Select Australia after importing to generate the correct report format.
  </Accordion>

  <Accordion title="Does KoinX support countries other than Australia?">
    Yes. KoinX supports 100+ countries with dedicated tax report formats for India, the US, UK, Canada, Germany, and more. Select your country after importing to generate the right report.
  </Accordion>
</AccordionGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Invalid API key error on connection">
    Verify the API key was created with **Read Only** permission. If the permission is incorrect, delete the key in BTC Markets and create a new one with the correct setting.
  </Accordion>

  <Accordion title="Secret Key is lost">
    The Secret Key cannot be recovered after the creation screen is closed. Go to BTC Markets → Account → API Key, delete the old key, and create a new one. Copy the new Secret Key immediately.
  </Accordion>

  <Accordion title="Transactions are not syncing">
    Try disconnecting and reconnecting the integration in KoinX. If that doesn’t work, delete the API key in BTC Markets, create a new one, and reconnect.
  </Accordion>

  <Accordion title="2FA verification failed during key creation">
    Ensure your authenticator app is in sync and enter the 2FA code quickly — codes expire after 30 seconds. Try again with a fresh code.
  </Accordion>

  <Accordion title="Some trades appear missing">
    Check that the API key has Read Only access to all account data. Disconnect and reconnect the integration. If trades are still missing, contact KoinX support.
  </Accordion>
</AccordionGroup>

***

## Related integrations

<CardGroup cols={2}>
  <Card title="CoinSpot Integration" icon="file-arrow-up" href="/integration/coinspot">
    Import CoinSpot trades via CSV file upload.
  </Card>

  <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 and import into KoinX.
  </Card>

  <Card title="Phemex : API Connect" icon="key" href="/integration/phemex">
    Connect Phemex via API key for automatic sync.
  </Card>
</CardGroup>

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