Skip to content

Latest commit

 

History

History
37 lines (27 loc) · 8.15 KB

README.md

File metadata and controls

37 lines (27 loc) · 8.15 KB

wash-sale-calculator

Calculator for wash sales for US taxes

Note that the author is not a CPA or tax expert. This program most certainly contains bugs.

To use, you'll need a CSV file with the initial state. I've provided a dummy one called dummy_example.csv.

To use the program from a terminal, run:

python wash.py -w dummy_example.csv -o out.csv

For help with other available options: python wash.py -h

The csv file must have one buy or buy-sell trade per row. Each row has the following columns:

ColumnHeader Type Description
Count integer # of shares in this lot
Symbol string stock symbol. Note that all symbols are considered substantially identical to each other, so if you trade in multiple stocks that aren't substantially identical, feed them into the calculator separately.
Desc string description provided on 1099b or statement. Unused by this program, but carried through for your records
Date Acquired date (mm/dd/yyyy) Date lot purchased
Cost Basis floating point number Acquisition price or basis. Value is typically share price on BuyDate * Cnt
Date Sold date (mm/dd/yyyy) Optional. If sold, the date of sale
Proceeds floating point number Optional. If sold, proceeds. Value is typically share price on SellDate * Cnt - fees
AdjCode string Optional. Must be empty for the input. May be set to W if there's a wash sale. This would go into the IRS form 8949.
Adjustment Amount floating point number Optional. Applies only if sold. Value is amount of loss disallowed. Input must have this set to 0. Output value may go onto IRS form 8949.
FormPosition string Optional but recommended. Useful for tracking this lot. When a lot is split, it will have '.1' or '.2' appended. Recommended is to enumerate all lines in your 1099b and use that number here. E.g., "Line 1" for the first lot on the 1099b.
BuyLot string Optional. Generally can be left blank. If two lots were acquired as part of the same buy order, put the same value here. This may occur if you bought a lot of stock, then sold off the lot in pieces (each piece would get a new line on the 1099b); if the broker automatically divided your buy order into pieces to execute; or if other factors caused the broker to split one buy lot into multiple lines on the 1099b. (This field is used because shares from a given buy lot can't replace shares from the same buy lot in a wash sale)
IsReplacement bool (True/False) Optional (left blank = False). This is set to true when the lot is used as a replacement in a wash sale. Since a lot may only be used as a replacement once, you can prevent a lot from absorbing a loss in wash sale computation by setting this to true.

If you commit changes to this software, make sure all tests are passing. To verify that all the tests pass:

python run_tests.py