If you live in the United States and use Coinbase, selling crypto, swapping one coin for another or spending it is usually a disposal for capital gains tax. Each disposal needs a value in dollars and a cost, matched to the lots you bought, with the holding period deciding whether the gain is short-term or long-term.
The rules themselves, including short-term and long-term gains, the per-wallet basis rule and Form 8949, are in our guide to crypto tax in the United States. This page covers the Coinbase part: getting your history out of Coinbase and what Coinfig does with it.
Connect Coinbase with an API key
Coinfig has a direct Coinbase API connection. Coinbase creates API keys in the Coinbase Developer Platform (CDP), not in the Coinbase app or your account settings, and API key access is switched off by default, so you may have to enable it first.
- Sign in to the Coinbase Developer Platform with your Coinbase account and open API Keys, then Secret API Keys.
- Click Create API key and give it a nickname.
- Expand API restrictions and keep the permission to View only. Leave Trade and Transfer off.
- Expand Advanced Settings and set the signature algorithm to ECDSA. Coinbase says Ed25519 does not work with its Coinbase App APIs.
- Click Create API key, then copy the key name and the API private key and paste both into Coinfig when you add Coinbase as a source. This is the exchange's API secret, not a wallet private key or seed phrase.
Official guide: Coinbase App API key authentication
How to download a Coinbase statement
If you would rather upload a file, Coinbase lets you generate a custom statement as a CSV. Statements are available from the date you opened your account.
- Sign in to Coinbase and open the Statements page.
- Choose the Asset, the Transaction type and the Date range from the drop-downs. Pick all assets, all transaction types and your full date range.
- Choose CSV as the format and select Generate.
- Download the file once it is ready.
Use the transaction statement as your source data, so Coinfig can apply the US rules to it. Export your full history, not only the current year, because a coin you sell this year may have been bought years ago.
Official guide: Account statements and your gain/loss report
What the Coinbase export gives you
- Buys, sells and conversions between coins, with the amounts on each side.
- Sends and receives, to and from your other wallets and exchanges.
- Rewards, such as staking, credited to your account.
It does not give you a US gain on its own. Coinbase does not know about coins you bought elsewhere and moved in, so its own figures can miss your basis.
How Coinfig turns it into US figures
- Imports trades, conversions, sends, receives and rewards through the API, or from your CSV statement.
- Values every transaction in dollars on the day it happened, whatever currency you traded in.
- Matches each disposal to a lot under the method you choose, FIFO by default, and marks it short-term or long-term from the holding period.
- Keeps staking and other rewards as income at their value when received, separate from your gains.
- Matches Coinbase sends to deposits on your other exchanges and wallets, so a move to yourself is not read as a sale.
- Runs a completeness check that flags gaps before you rely on the figures.
Where the figures go on Form 8949
Coinfig's US report gives your disposals for the calendar year split into short-term and long-term, with proceeds, basis and gain or loss for each, as Form 8949 and Schedule D ask for. Income from rewards is shown separately.
Coinfig does not hold capital loss carryovers from earlier years or work out your rate, which depends on your whole return, so you add those yourself.
Coinfig is a calculation and reporting tool, not tax advice, and it does not file your return. Check the figures, or have a tax adviser check them, before you file.
Frequently asked questions
Is a coin to coin conversion on Coinbase taxable in the US?
Yes. The IRS treats swapping one coin for another as a disposal, with the gain measured in dollars at the fair market value of what you receive.
Does a View key let Coinfig move my crypto?
A key you create with View only, and with Trade and Transfer left off, gives read access to your history. Create the key with those settings before you paste it into Coinfig.
Do I need my whole Coinbase history?
Yes. The cost of a sale this year can come from a purchase years ago, so a full export lets Coinfig find it.
Get started on Coinfig to connect Coinbase or upload your exports, check for gaps and work out your US figures.
This article is general information, not tax advice. Your position depends on your own circumstances. For anything complex, ask a qualified tax adviser.