The tax calculator for inter EURO crypto and cross crypto trades on the kraken.com exchange.
This project focuses on easy annual tax report generation based on data from cryptocurrency exchanges. It aims to set competition to paid apps. The calculation uses the taxHowever, it will not serve as a hand-in report generator for your national tax administration.
This project, code, procedures and results are not to be regarded as financial, accounting or tax advise for your country!
Prerequisites: git and Python 3.
- Clone the repository
- Install its dependencies via
pip install -r requirements.txt
- Export your trades from the kraken.com exchange inside your account area. Download the trades in the
.csv
format, not the ledger. We do promise that the code does not and never upload your trading values to any external machine. Note, that price queries of the cryptocurrencies of your trades are made against against cryptocompare.com, at least once, to gather the needed data for earnings and profits calculations. Also note that proper tax calculation via the FIFO method does need a full or at least fully independent trading history. - Place the
trades.csv
file into thedata/raw/
directory. - Run the python script via
python3 run.py
. Note that there are options which you can specify, see below. - Watch the cli output, look into
data/export/
if you exported the data. You can also find the used prices indata/history/
which are used in the calculation as references.
You can specify options as arguments to your cli call via for example --option
, or in short -opt
. A detailed list can be found in the file octotax/utils.py
.
--year 1234
- specifies the year1234
which you want to report alone. By default all years will be reported in the output.--export
- outputs a MarkDownreport.md
as well as a PDFreport.pdf
into thedata/export/
directory.--tax-rate 50
- specifies the tax rate which will be applied to your profits.
The directory data/temp/
is for data transfer in between modules for large trading history data files to not abuse RAM of your machine.
This is an open source project and you are invited to participate. If you find a bug do not hesitate to submit and issue or even fix it yourself and make a pull request. If you want to extend the program to another exchange, fiat currency or just have feature requests, please make an issue or pull request if you already have working code.
Best regards, HODL team
(We are not affiliated with the hodlbot-io website in any way. Actually we've been around here before their webpage.)