Skip to content

Releases: MiguelTVMS/broker_to_tax

v1.1.0

26 Apr 15:28
Compare
Choose a tag to compare

What's Changed

  • Separated fees from dividends.

Full Changelog: v1.0.1...v1.1.0

v1.0.1

14 Apr 17:15
Compare
Choose a tag to compare

What's Changed

Full Changelog: 1.0.0...v1.0.1

Version 1.0.0

14 Apr 14:56
Compare
Choose a tag to compare

Version 1.0.0

Warning
Use this application at you own risk. This is a hobby project. I'm not a tax expert. I'm not a lawyer. I'm not a financial advisor. I'm just a guy that likes to code and likes to invest. I'm not responsible for any damage this application may cause. If you have any doubts about your taxes, please consult a professional.

How to use it

Download it form the releases page. It's strongly recommended to use the latest version.

The tool is very simple, you must provide the file where the source operations are available in csv format. Read the eToro section in Supported Brokers to know how to generate the csv.

Heres an example of how to use it to generate the csv for eToro stock operations grouped by source country.

brokertotax etoro stock -f "path/to/etoro_closed_positions.csv" -g source-country

This will generate a csv file with stock operations grouped by country. The file will be named stock_gains_grouped_by_source_country.csv. This file is ready to be used as base for the Portuguese IRS form categories G or E.

The application support these kinds of operations, stock, crypto, CFD, and ETF. The stock operations can be grouped in source-country and operations by using the -g or --group-by parameter. Other operations can be grouped in other ways, see the help for more information.

brokertotax etoro -h

Will output something like this:

Convert eToro data to a format that can be imported into tax software

Usage: brokertotax etoro <subcommand> [arguments]
-h, --help    Print this usage information.

Available subcommands:
  cfd      Convert CFD data to a format that can be imported into tax software
  crypto   Convert crypto data to a format that can be imported into tax software
  etf      Convert ETF data to a format that can be imported into tax software
  stock    Convert stock data to a format that can be imported into tax software

Run "brokertotax help" to see global options.

Each command has it own help. For example:

brokertotax etoro stock -h

Will output something like this:

Convert stock data to a format that can be imported into tax software

Usage: brokertotax etoro stock [arguments]
-h, --help                  Print this usage information.
-f, --file                  The file to parse.
    --exchange-directory    The directory containing the exchange rates
                            (defaults to "data/exchange")
-c, --currency              The currency to use for the gains.
                            [usd, eur (default)]
-g, --group-by              The grouping to use in the gains.
                            [none (default), source-country, operation]

Run "brokertotax help" to see global options.

Check the full help for know more about about the available options.

Supported Brokers

This first version is being developed to support eToro. But the idea is that new brokers can be added by pull requests. The code is being created to be simple to add a broker.

eToro

How to get the operations in eToro:

  1. Go to the Account Statement page.
  2. Select the last year option.
  3. Click on create.
  4. Click on the green document icon with "xls" written inside it.
  5. Save the file.
  6. Open the file using excel and go to the Closed Positions sheet.
  7. Go to File » Save As and choose CSV as format.
  8. Click on save. An alert will rise telling that it will only save the current sheet since CSV doesn't support multiple sheets, click Ok.
  9. Run the command as specified in How to use it section.

0.10.0-beta

14 Apr 13:25
Compare
Choose a tag to compare
0.10.0-beta Pre-release
Pre-release

Alpha 0.10.0

Warning
Use this application at you own risk. This is a hobby project. I'm not responsible for the correctness of the correctness of the data generated by this application and personal fiscal damage it may incur.
This application is on a very early development phase.

  • Ability to generate the output in a format that easily apply to the portugal IRS system..
    • Transactions grouped by country for stocks and ETFs.
    • Transactions grouped by crypto currency.
    • Transactions grouped by CFD.
    • Added testing for the full commands.

Version 0.9.0 (Alpha)

10 Apr 23:12
Compare
Choose a tag to compare
Version 0.9.0 (Alpha) Pre-release
Pre-release

Version 0.9.0 (Alpha)

Note
This application is in a very early development phase.

  • Able to interpret the eToro summary file.
  • Able to group the transactions by type in Gains format.
  • Generate a CSV output file for each gain type.

Full Changelog: https://github.com/MiguelTVMS/broker_to_tax/commits/0.9.0-alpha