A tool to calculate the capital gains of cryptocurrency assets for Canadian taxes. The source data comes from a set of trade logs, which are provided by the exchanges. The adjusted cost base (ACB) is used to calculate the capital gains.

I created this software to calculate the capital gains from my 2017 cryptocurrency trades for tax purposes. For my 2018 taxes, I refined the software with many new options to handle missing logs, stolen assets, and other complex issues.

Please note that I am not an accountant, and I do not warrant the validity of the results.

The following exchanges are supported out-of-the-box:

• Binance
• Bittrex
• Kraken
• KuCoin

It is easy to add support for additional exchanges. Simply add a parser in trade-parse-stream.js to convert a CSV row to the normalized format. You can look at the existing parsers as examples of how to do this.

Run the program with npm start or node index. Add the --help option to see the available options.

Typical usage involves running the program with a set of trade logs in the form of CSV files. For example:

node index data/*-2018.csv -odata/results-2018.md --init=\
BTC:0.73396222:12721.04,\
ETH:4.18451232:3478.97,\
LTC:11.09684:3113.88

The resulting Markdown or HTML contains:

• The assets carried forward from the previous year (if any).
• A list of trades, ordered by time, including fees and the running ACB.
• A list of dispositions, ordered by asset and time, including the POD, ACB, OAE, and the running gain (or loss).
• A summary of the aggregate dispositions per asset.
• A summary of the aggregate gain (or loss), ACB, and remaining balance per asset.
• The total taxable capital gains.
• The assets that can be carried forward to the next year (if any).

There are options for filtering by currency, defining the initial balance, limiting the number of trades, and providing historical data.

^[1] A subset of the available assets can be considered for the calculation by the --assets option, or used to filter the results by the --show option. The argument in both cases is a comma-separated list of assets.

^[2] The balances can be carried forward from last year by the --init option. The argument is a comma-separated list of assets, each with its balance and adjusted cost base, in the form of <asset>:<balance>[:<acb>],..., such as --init=BTC:1:5000,ETH:5:1000,LTC:10:80.

^[3] Historical data may be provided to the program using the --history option.

The data for each currency pair must be stored in a JSON file named <base>-<quote>.json. Each JSON file must contain an array of historical samples, ordered by time. Each historical sample must contain the following fields:

Compatible files can be generated by the @davidosborn/crypto-history-parser npm package.