Coinbase Import Guide

How to Import Your Coinbase Trades

Step-by-step guide to importing Coinbase trade history into TradingAtlas via read-only API sync or CSV upload. Set up a read-only API key, fix common errors, and track PnL and taxes.

Read-only API (Coinbase Exchange key/secret/passphrase), plus CSV

About importing from Coinbase

Coinbase serves both retail (Advanced Trade) and professional (Coinbase Exchange) users, primarily for spot trading. Credential and export formats differ between the products.

TradingAtlas accepts Coinbase Exchange API credentials (key, secret, passphrase) and CSV exports from Retail, Advanced Trade, and Exchange, consolidating buys, sells, conversions, and rewards.

Quick facts

API syncYes
API statusRead-only API (Coinbase Exchange key/secret/passphrase), plus CSV
CSV importYes
CSV exports supportedCoinbase Advanced Trade fills, Coinbase transaction history, Coinbase Exchange/Pro fills
Futures / perpetualsNo
Funding feesNo

Connect Coinbase via API (recommended)

Create a read-only Coinbase API key so trades sync automatically.

  1. 1Log in to Coinbase Exchange on the web.
  2. 2Open Profile and go to API settings.
  3. 3Click New API Key.
  4. 4Select the portfolio/profile TradingAtlas should read.
  5. 5Enable View permission only.
  6. 6Leave Trade, Transfer, and Manage disabled.
  7. 7Set and save the passphrase.
  8. 8Add IP restrictions if Coinbase requires or offers them.
  9. 9Complete 2FA verification.
  10. 10Copy the API Key, API Secret, and Passphrase.
  11. 11Paste all three values into TradingAtlas, click Test, then Save Connection.

Required Coinbase API permissions

Read-only access is all TradingAtlas ever needs — never enable trading or withdrawals.

Passphrase required

Coinbase requires the passphrase you set when creating the API key. It is not your login password and cannot be recovered — store it safely and paste it into the passphrase field in TradingAtlas.

Import Coinbase via CSV

Prefer files? CSV upload works for every account.

  1. 1Open your Coinbase account and locate the trade history / statements export.
  2. 2Export your full Coinbase trade history as CSV.
  3. 3Export deposits, withdrawals, and fee records if provided separately.
  4. 4Open TradingAtlas and go to Import → CSV.
  5. 5Upload the Coinbase files — columns are detected and mapped automatically.
  6. 6Review the normalized trades and confirm the import.

Coinbase CSV exports TradingAtlas reads

Upload any or all of these — they are merged into one timeline.

Known Coinbase quirks

Platform-specific behavior that affects imports.

Common Coinbase import issues

Quick fixes for the problems traders hit most often.

Security best practices

What happens after import

Once your Coinbase trades are imported, TradingAtlas builds an automated trading journal, calculates realized PnL and win rate, and prepares cost-basis data for tax reporting — all from the same normalized history.

Frequently asked questions

How do I import my Coinbase trades into TradingAtlas?
Connect a read-only Coinbase API key for automatic sync, or upload Coinbase CSV exports (Coinbase Advanced Trade fills, Coinbase transaction history, Coinbase Exchange/Pro fills).
What Coinbase API permissions do I need?
Read-only access only — View. Never enable trading or withdrawal permissions.
Which Coinbase CSV exports work?
Yes. Upload Coinbase CSV exports — Coinbase Advanced Trade fills, Coinbase transaction history, Coinbase Exchange/Pro fills — and columns are detected and mapped automatically.
Are there any Coinbase quirks I should know about?
Coinbase Advanced Trade (CDP) keys differ from Coinbase Exchange key/secret/passphrase credentials.
My Coinbase import isn't working — what should I check?
Coinbase Advanced Trade CDP keys are different from Coinbase Exchange key/secret/passphrase credentials — confirm which you have.
Is my Coinbase data secure?
API keys are read-only and stored encrypted. TradingAtlas can never trade or withdraw from your account.

Import your Coinbase trades now

Connect Coinbase via read-only API or CSV and start tracking PnL and taxes.

Start for free →

No credit card required · Free plan available

Explore TradingAtlas