> ## 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 Import Coinbase Transactions into KoinX

> Connect Coinbase to KoinX via API key or CSV file upload and import your transaction history to generate your country-specific crypto tax report.

<Info>
  **File Upload · API Key**  ·  **5-10 min**  ·  Spot · Deposits · Withdrawals · Staking  ·  **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="Deposits and Withdrawals" color="#0066CC" icon="building-columns">
    On-chain deposits and withdrawals.
  </Card>

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

  <Card title="Full transaction history" color="#0066CC" icon="clock-rotate-left">
    Complete history via API or CSV export.
  </Card>
</CardGroup>

## Before you start

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

**Coinbase supports two integration methods - API Key and File Upload.** Connect via API key for a direct integration, or export your transaction history as a CSV file and upload it to KoinX. Pick one method below.

<Tabs>
  <Tab title="API Key">
    <Steps>
      <Step title="Log in to Coinbase">
        Go to coinbase.com and sign in to your account. On the Dashboard, find the option to **Generate API Keys** and select it.
      </Step>

      <Step title="Generate your API Key and Secret Key">
        Follow the on-screen directions to generate your keys. Copy both the **API Key** and the **Secret Key**.
      </Step>

      <Step title="Open KoinX Integrations">
        Log in to app.koinx.com -> **Integrations** -> **Add Integration**. Search for **Coinbase** and select it.
      </Step>

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

      <Step title="Submit">
        Click **Submit**. Your Coinbase account is integrated and KoinX imports your transaction history.
      </Step>
    </Steps>

    <Note>
      **Optional - Opening Balance File.** To avoid importing older historical transactions, upload your balances as of a specific date. Click **Download Opening Balance Template** on the integration screen, fill it in, and upload it in the same step.
    </Note>

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

  <Tab title="File Upload">
    Export your Coinbase transaction history as a CSV file, then upload it to KoinX.

    <Steps>
      <Step title="Log in to Coinbase">
        Go to coinbase.com and sign in to your account.
      </Step>

      <Step title="Open Orders">
        Click **Orders** in the left column of the screen.
      </Step>

      <Step title="Click View Statement">
        Click the **View Statement** option. You will be redirected to a new tab.
      </Step>

      <Step title="Select transaction type and date">
        Under **Transaction Type**, select **All Transactions**. Under **Date**, click **Year to Date** and select your year.
      </Step>

      <Step title="Select CSV and generate">
        Set the file format to **CSV**, review your selections, and click **Generate**. Download the file when it is ready. Do not open it.
      </Step>
    </Steps>

    <Note>
      Repeat the export for each year you traded to capture your complete history. You can upload all files together in KoinX.
    </Note>

    ## Upload to KoinX

    <Steps>
      <Step title="Open KoinX Integrations">
        Log in to app.koinx.com -> **Integrations** -> **Add Integration**.
      </Step>

      <Step title="Select Coinbase">
        Search for **Coinbase** and select it.
      </Step>

      <Step title="Upload all your files">
        Open the **Upload Data** tab, click **Upload**, and select all your Coinbase CSV files at once. 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, deduplicates overlapping records, and prepares everything for gains calculation and report generation.
    </Check>

    <Warning>
      **Never open Coinbase CSV files in Excel or Google Sheets before uploading.** This corrupts the file format. If you already did - re-export a fresh copy from Coinbase.
    </Warning>
  </Tab>
</Tabs>

Now that your Coinbase data is in, head to Tax Reports on KoinX - your capital gains across spot trades and staking rewards are already calculated and your report is ready to download.

***

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Should I connect Coinbase via API key or file upload?">
    Use the API key method for the fastest setup - KoinX pulls your transaction history directly from Coinbase. Use file upload if you prefer not to generate API keys or want to control exactly which date ranges are imported. Both methods produce the same tax calculations.
  </Accordion>

  <Accordion title="How far back should my Coinbase export date range go?">
    Download transaction reports from the day you created your Coinbase account to capture your complete history. Partial exports lead to missing transactions and inaccurate tax calculations.
  </Accordion>

  <Accordion title="Does KoinX sync Coinbase transactions in real time?">
    File upload does not support real-time syncing - generate and upload a fresh CSV whenever you need your latest transactions reflected. With the API key method, KoinX fetches your transaction history directly from Coinbase, so refreshing your data does not require new file exports.
  </Accordion>

  <Accordion title="Does Coinbase provide tax reports directly?">
    No. Coinbase does not provide tax-ready reports for direct filing. By integrating Coinbase with KoinX, you can import your transaction history and generate a compliant, country-specific crypto tax report 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 Coinbase data, select your country to generate the correct report.
  </Accordion>
</AccordionGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="CSV file won't upload to KoinX">
    Re-download a fresh copy of the statement from Coinbase without opening it. Opening the file in Excel or Google Sheets reformats date and number columns, breaking the file structure KoinX expects. Ensure the file format is CSV only.
  </Accordion>

  <Accordion title="KoinX says my Coinbase API key is invalid">
    Re-check that both the API Key and Secret Key were copied in full with no extra spaces. If the error persists, generate a fresh set of keys from your Coinbase Dashboard and submit them again in the **API Key** tab.
  </Accordion>

  <Accordion title="Transactions are missing after upload">
    Check that your export date range covers the full history of your Coinbase account from the day it was created. Upload separate files for each year if needed - upload all files together in one KoinX session.
  </Accordion>

  <Accordion title="Staking rewards are not appearing in KoinX">
    Staking reward records are included in the standard All Transactions CSV export. Confirm the date range covers the full staking period. If gaps remain, re-export with an earlier start date and re-upload.
  </Accordion>

  <Accordion title="KoinX is showing duplicate Coinbase transactions">
    This happens when overlapping CSV files covering the same date range are uploaded, or when the same account is connected via both API and file upload. Go to **KoinX** -> **Integrations**, remove the duplicate Coinbase integration, and keep a single connection covering your full history.
  </Accordion>

  <Accordion title="Generate button is not producing a file">
    Reduce the date range and generate multiple smaller files. Exports covering very long periods may time out on Coinbase's end. Upload all smaller files together in KoinX.
  </Accordion>
</AccordionGroup>

***

## Related integrations

<CardGroup cols={2}>
  <Card title="Binance - File Upload" icon="chart-bar" href="/integration/binance">
    Export Binance CSVs and import into KoinX.
  </Card>

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

  <Card title="Kraken Integration" icon="anchor" href="/integration/kraken">
    Import Kraken trades via API or file upload.
  </Card>

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

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