How to export Coinbase CSV for Koinly? (Tax integration)

Accessing Your Coinbase Transaction History

1. Log into your Coinbase account using verified credentials and navigate to the Reports section located under the Portfolio or Settings dropdown menu depending on your interface version.

2. Select Transaction History to view a chronological list of all trades, deposits, withdrawals, staking rewards, and conversions across all linked wallets and accounts.

3. Ensure that date filters are set to cover the full tax year or reporting period required by your jurisdiction—Koinly supports imports spanning multiple years but performs best with consolidated yearly exports.

4. Confirm that all relevant accounts—including Coinbase Pro, Coinbase Wallet (if connected), and any custodial staking sub-accounts—are toggled for inclusion in the export.

Generating the Correct CSV Format

1. Click the Export Transactions button, which triggers a background generation process—this may take up to 90 seconds for accounts with over 50,000 entries.

2. Choose CSV (All Transactions) as the file type; avoid selecting “Summary Only” or “Tax Report” options since Koinly requires granular line-item data including timestamps, fees, counterparties, and asset identifiers.

3. Verify that the exported CSV contains at least the following columns: Date, Type, Asset, Amount, Fiat Currency, Fiat Amount, Fee Amount, Fee Currency, Notes. Missing fields like Fiat Amount or Fee Currency will trigger parsing errors in Koinly.

4. Do not manually edit the CSV after export—altering column order, deleting rows, or inserting blank lines breaks Koinly’s ingestion logic and leads to mismatched cost bases or unclassified transactions.

Handling Multi-Account and Legacy Data

1. If you hold assets across Coinbase.com, Coinbase Pro, and standalone Coinbase Wallet, generate separate CSVs for each environment—Koinly accepts multi-file uploads but maps them by wallet address and timestamp, not by platform label.

2. For accounts created before 2019, check whether legacy transaction types like “Send” or “Receive” include blockchain confirmation details; older exports sometimes omit fee breakdowns, requiring manual supplementation via Etherscan or Blockchair lookups.

3. Staking rewards and interest earnings appear as “Staking Reward” or “Interest Payment” in the Type column—these must retain their original fiat valuation at time of receipt to satisfy Koinly’s income classification engine.

4. Convert all CSV files to UTF-8 encoding before upload; files saved in Windows-1252 or ISO-8859-1 cause character corruption in asset tickers such as “XLM” or “ALGO”, resulting in unrecognized token errors.

Uploading to Koinly and Validating Parse Results

1. In Koinly, go to Wallets > Add New Wallet > Coinbase, then select Upload CSV instead of API integration to preserve full transaction fidelity including internal transfers and failed orders.

2. Drag and drop the CSV file(s) into the designated zone—Koinly processes each row independently and assigns auto-detection tags like “Trade”, “Deposit”, or “Airdrop” based on pattern matching against 170+ known Coinbase event signatures.

3. After parsing completes, review the Unclassified Transactions tab—entries flagged as “Unknown” often stem from unsupported asset pairs (e.g., ETH/DAI swaps pre-2022) or missing counterparty data in Coinbase’s raw export.

4. Cross-check five randomly selected trades against your Coinbase transaction IDs—Koinly displays the original Transaction Hash or Order ID in the Details panel, enabling direct verification without external tools.

Frequently Asked Questions

Q: Does Koinly support Coinbase Wallet mobile app exports?Yes—open Coinbase Wallet, tap the three-dot menu, select Export Transactions, and choose CSV. The resulting file includes wallet-level on-chain activity but excludes centralized exchange trades unless manually merged.

Q: Why does Koinly show duplicate entries after uploading a Coinbase CSV?Duplicates occur when the same transaction appears in both a main Coinbase.com export and a linked Coinbase Pro export—Koinly treats them as independent events unless identical timestamps, amounts, and asset pairs align precisely.

Q: Can I export Coinbase taxes directly to Koinly without downloading a CSV?No native API-based tax export exists—Coinbase only provides real-time API access for balances and recent trades, not historical tax-grade records. CSV remains the sole supported method for full audit trails.

Q: What happens if my Coinbase CSV lacks fiat values for old transactions?Koinly applies fallback pricing using its internal historical oracle, but this may deviate from local tax authority requirements—manually editing the CSV to insert correct USD/EUR/GBP values at time of execution is mandatory for compliance.