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

> Connect your Luno 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="Luno 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 Luno to KoinX

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

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

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

      <Step title="Open your Profile">
        Click the **profile icon** in the top right corner.
      </Step>

      <Step title="Go to Security">
        Select **Security** from the profile menu.
      </Step>

      <Step title="Open API Keys">
        Click on **API Keys**.
      </Step>

      <Step title="Create a new API key">
        Click **Create API Key**. Enter a label for your key and select **Read-only access** in the Permissions field.

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

    Once your Luno 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.
      * **Use Sync Now** to pull the latest Luno transactions into KoinX at any time from the Integrations panel.
    </Note>
  </Tab>
</Tabs>

***

## Frequently asked questions

<AccordionGroup>
  <Accordion title="What permissions does the Luno API key need for KoinX?">
    Read-only access 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 Luno show my Secret Key again after I leave the page?">
    No. Luno displays the Secret Key only once at the time of creation. Copy it immediately and store it securely. If lost, delete the key from Security -> API Keys and generate a new one.
  </Accordion>

  <Accordion title="Do I need to report my Luno transactions for tax purposes?">
    Yes. You must report your taxes if you are engaged in crypto transactions via Luno or any other exchange. Follow the tax provisions set by the relevant authority in your country.
  </Accordion>

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

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="API key error on connection">
    Confirm the key was created with Read-only access in **Luno** -> **Profile** -> **Security** -> **API Keys**. Delete the credentials in KoinX and re-enter both values carefully - copy directly from Luno to avoid invisible characters.
  </Accordion>

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

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

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

  <Accordion title="Wrong permissions were selected during API creation">
    Delete the existing key from **Luno** -> **Security** -> **API Keys**, generate a new key with Read-only access only, and reconnect in KoinX with the new credentials.
  </Accordion>

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