TLDR: You can import your Coinbase transactions into CoinTracking via API or CSV. We strongly recommend using the API because it includes transfers between Coinbase and Coinbase Pro, which the CSV does not. Be sure to delete existing Coinbase data before switching import methods. CSV and API imports are not compatible. If you trade Coinbase perpetual futures or margin products, these require a separate PnL-formatted import.
How Can I Import My Coinbase Transactions?
You have two options:
1. API Import (Recommended)
Go to your Coinbase account, generate API keys with appropriate permissions.
Follow CoinTracking's API guide to insert the keys into your account.
This method includes internal transfers like Coinbase to Coinbase Pro.
2. CSV Import
Export your trade history from Coinbase in CSV format.
Go to CoinTracking’s Coinbase Import page and upload the file.
Important: The Coinbase CSV does not include transfers from or to Coinbase Pro. You must add those manually unless you use the API.
Tip: If you're importing data from multiple exchanges into your account, it's best to import them one at a time rather than simultaneously. Running several imports in parallel can increase the chance of errors or incomplete data.
Can I Use Both CSV and API Imports?
No. The Coinbase CSV and API are not compatible. If you've previously imported Coinbase data using a CSV:
Make a backup of your account.
Go to the Bulk Delete section and remove all Coinbase transactions.
Then set up and use the API importer instead.
What Should I Do if My API Import Isn’t Working?
Try the following steps:
Click "Check now" on the API job page.
If the issue persists, delete the existing API job and create a new one.
Ensure your API key and secret are copied without spaces and have the correct permissions.
If your secret key isn’t displaying, try disabling browser extensions like Privacy Badger or turn off antivirus temporarily.
Note: Coinbase APIs may take a few minutes to hours to complete the import. Be patient.
What If I Get an "API Key Invalid" Error?
This usually happens when Coinbase upgrades their API version. The fix:
Log into Coinbase
Go to the API page
Update the API version
Generate a new API key
Reconnect with CoinTracking using the new key
Vault Transactions Are Not Importing Correctly
If you're using a Coinbase Vault in addition to your standard wallet:
Some internal transactions might share the same transaction ID and get skipped.
You may notice duplicate deposits or withdrawals.
Also note that Coinbase Pro can sometimes deliver unreliable or incomplete transfer data for movements between Coinbase and Coinbase Pro, which may also result in missing or duplicated entries.
Workaround Options:
Edit one of the duplicate withdrawals and turn it into a deposit.
Alternatively, create missing deposits or withdrawals manually and label them clearly (e.g., "Coinbase Vault").
Tip: After making these manual corrections, change the start date in your Coinbase API job to avoid overwriting.
How Do I Import Coinbase Perpetual Futures or Margin Trades?
Coinbase perpetual futures and other leveraged/margin trades cannot be imported like standard spot transactions. Instead, they must be imported as PnL (profit and loss) data, using the transaction types Margin Profit and Margin Loss.
CoinTracking cannot calculate margin/futures profit or loss itself. The exchange must provide these PnL figures directly in the export file.
A standard Coinbase transaction CSV is not sufficient for perpetual futures. You need a specific PnL-formatted file with the correct headers.
If you're unsure whether your export contains proper PnL data, check with Coinbase support to confirm the file includes the correct PnL figures and headers before importing.
For details on how the Margin Loss/Profit delta is calculated once imported, see CoinTracking's documentation on margin trading calculations.
Check out our Video Guide:
Summary
Use API over CSV for a complete history including Coinbase Pro transfers.
Do not mix import methods. Delete old data before switching.
Manual correction is sometimes required, especially for vaults and unreliable Coinbase Pro transfer data.
API errors can often be fixed by re-generating your key or correcting browser issues.
Perpetual futures/margin trades require a separate PnL-formatted file (Margin Profit/Margin Loss). Verify the correct format with Coinbase support.
When importing multiple exchanges, do them one at a time to avoid conflicts.