sprolosta/README.md

A nodejs app that computes the profit / loss of stock trading for each financial year

# shares-profit-loss-tax
Shares PROfit / LOSs TAx (SPROLOSTA or sprolosta) is a profit / loss calculator for stock trading in Australia.

It is coded in nodejs and can be used for computeing the profit / loss of stock trading for each financial year. And the profit for any assets that are held more than 12 months is entitled to a 50% discount.

## Australian Taxation Office (ATO) rules
The ATO rules for calculating the profit / loss of stock trading are as follows:
- The profit / loss is calculated for each financial year
- The profit / loss is calculated by summing the profit / loss of each stock trade
- The profit / loss of each stock trade is calculated by subtracting the buy price from the sell price

Any assets hold more than 12 months are entitled to a 50% discount on the profit / loss.

## Supported Brokers
- CommSec
- FP Markets

As the author only has accounts with these two brokers, only these two brokers are supported at the moment. However, the author is happy to accept pull requests for other brokers.

## Installation and Usage

### Installation
```bash
npm install -g sprolosta
```

### Usage

#### Split and Consolidation of Shares

If you have shares that have been split or consolidated, you will need to adjust the transactions manually.

```bash
sprolosta <--broker broker> <--symbol symbol1,symbol2,..> <csv file>
```

#### Example 1

```bash
sprolosta --broker commsec Transactions_2540927_01072022_30062023.csv
```

#### Example 2 - Multiple CSV Files

```bash
sprolosta --broker fpmarkets 2020.csv 2021.csv 2022.csv 2023.csv

```

#### Example 3 - Check Only a Few Symbols

```bash
sprolosta --broker fpmarkets --symbol AKE,MP1,VSR 2020.csv 2021.csv 2022.csv 2023.csv

```

## Disclaimer

- The author of this project is not responsible for any loss or damage caused by the use of this project.

- Always consult a professional tax accountant for your tax matters.

## Donation
If you find this project useful, please consider donating to the author.

Bitcoin: TSvSd6BMhVYKWJWainRvtzaDH6usPBYW4p

## Maintainer

[Eric Tang](https://twitter.com/_e_tang) @ [TYO Lab](http://tyo.com.au)