/tastyworks-pnl

prepare German tax statement with Tastyworks transaction history

Primary LanguagePythonBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

Tastyworks PNL

This python script is used to generate data for a private German tax income statement from Tastyworks csv-file with trade history.

How to use

Download your trade history as csv file from https://trade.tastyworks.com/index.html#/transactionHistoryPage. (Choose "Activity" and then "History" and then setup the filter for a custom period of time and download it as csv file.)

Newest entries in the csv file should be on the top and it should contain the complete history over all years. (You can at most download data for a year, so for several years you have to download into several files and combine them into one file with a texteditor.) The csv file has the following first line:

Date/Time,Transaction Code,Transaction Subcode,Symbol,Buy/Sell,Open/Close,Quantity,Expiration Date,Strike,Call/Put,Price,Fees,Amount,Description,Account Reference

If you delete the eurusd.csv file, a current version is downloaded directly from https://www.bundesbank.de/de/statistiken/wechselkurse. (Link to the data: eurusd.csv)

The option --usd can be used to not translate pnl data into Euro.

The option --verbose adds currency gains for each transaction.

Per default balance adjustments are only output as total sum, you can use the option --long to include balance adjustments into the list of transactions.

Per default the script stops on unknown trading symbols (underlyings) and you have to hardcode into the source code if it is an individual stock or some ETF/fond. You can use the --assume-individual-stock option to assume individual stock for all unknown symbols.

Currency gains are only summed up within the first year and if no credit is paid back, otherwise they are tax free. Also if dividents or credit is received or account fees are paid. (They need to go into 'Anlage SO' within a private German tax statement.)

The option --debug-fifo gives details on the FIFO workings. Be aware that pnl data is the cummulative sum, not the real local change. (Bug in the output!)

The option --show gives some summary graphs.

If you work on Linux with Ubuntu/Debian, you need to make sure https://pandas.pydata.org/ is installed:

sudo apt-get install python3-pandas

CSV and Excel Output

The script can also output all data again as CSV file or as Excel file. (CSV should be most robust, I don't have much experience with excel. I'd recommend CSV and just reading it into a new Excel sheet yourself. Both data types contain the same output data.)

The options for this are --output-csv=file.csv and --output-excel=file.xlsx.

The output contains the important original data from the Tastyworks csv file plus pnl generated data as well as eurusd conversion data. You probably do not have to provide all data in a tax statement, some is only added for further data processing convenience in your spreadsheet program. Here the output transaction data in detail:

  • datetime: Date and time (Tastyworks gives minutes for this, no exact seconds) of the transaction
  • pnl: pnl for tax payments for this transaction based on FIFO
  • usd_gains: currency conversion gains for the account in USD. Based on cash changes in USD due to this transaction.
  • usd_gains_notax: as above, but not part of German tax law
  • eur_amount: 'amount - fees' converted into Euro currency
  • amount: transaction amount in USD
  • fees: cost of transaction in USD that needs to be subtracted from amount
  • eurusd: official eurusd conversion rate for this transaction date from bundesbank.de
  • quantity: number of buys or sells
  • asset: what is bought (stock symbol or something like 'SPY P310 20-12-18' for an option
  • symbol: base asset (underlying) that is traded. This is included to be able to generate summary overviews for e.g. all transactions in SPY with stocks and options combined.
  • description: additional informational text for the transaction
  • account_total: account cash balance in USD after this transaction. This is the previous account total plus 'amount - fees' from this transaction. (Cash amount at Tastyworks.) This is purely informational and not needed for tax data.
  • net_total: Sum in USD of account_total (cash) plus all assets (stocks, options) in your account. This does not use current market data, but keeps asset prices at purchase cost. Best looked at to check if this script calculates the same total sum as shown in your Tastyworks current total.
  • term_loss: how much does this transaction contribute to losses in future contracts ('Verlustverrechnungstopf Termingeschäfte')
  • tax_free: are further currency changes tax free (German: steuerneutral)

FAQ

  • Maybe ACH transfers are not yet implemented. I don't use them, maybe email me a sample transaction line, so that I can adjust the source code.
  • Either github issues or email works for me to enhance/fix this program. Sample data is best to resolve issues.

Currency gains in German tax law

Discussion in German about Germany tax law on currency gains:

Links:

Zusammenfassung Steuern im Privatvermögen bei Fremdwährungskonten:

  • Bei der Anschaffung und Veräußerung von Fremdwährungsbeträgen kann es sich um ein privates Veräußerungsgeschäft i.S. des § 23 Abs. 1 Satz 1 Nr. 2 EStG handeln. Diese werden in der privaten Einkommensteuererklärung in der "Anlage SO" angegeben.
  • Da die Gewinne aus § 23 EStG nicht dem Steuerabzug unterliegen, ermitteln die inländischen Banken diese Gewinne in der Regel nicht. Die Einkünfte müssen daher eigenständig ermittelt werden und - sofern die Freigrenze des § 23 Abs. 3 EStG von 600 € überschritten ist - in der Einkommensteuererklärung (Anlage SO) erklärt werden. BMF, Schreiben v. 18.1.2016 - IV C 1 - S 2252/08/1004:017, BStBl 2016 I S. 85 NWB WAAF-66193, Rz 131.
  • Unterliegen nicht der Abgeltungssteuer sondern dem persönlichen Steuersatz.
  • Fremdwährungen fallen nicht unter die Abgeltungssteuer/KapESt und werden daher von den Banken auch nicht in Ihrem Steuer-Reporting erfasst. Der Steuerpflichtige muss dies eigenverantwortlich übernehmen.
  • Währungen gelten als Spekulationsgeschäfte, steuerbar beim Verkauf (betrachte das fremde Geld einfach als Wertpapiere)
    • Ein Konto in einer nicht-Euro-Währung gilt als eigenes Asset und muss besteuert werden.
  • Für die Veräußerungsgewinnberechnung gilt die FiFo-Methode.
  • die Spekulationsfrist beträgt ein Jahr (bei verzinster Anlage 10 Jahre), danach ist es immer steuerfrei
  • Freigrenze 600 Euro (für alle Spekulationsgewinne zusammen), darunter immer steuerfrei
  • Verluste werden in einem extra Verlustverrechnungstopf vom Finanzamt vorgetragen und können (auf Antrag) nur mit Gewinnen aus dem Vorjahr verrechnet werden.
  • Dividendenauzahlungen/Optionsprämien/Zinsen in Fremdwährung sind keine "Anschaffung" von Währungsguthaben im Sinne von § 23 EStG (da gilt eine enge Auslegung des Anschaffungsbegriffs), sondern ein Zufluss (Der Zufluss an sich fällt ja unter § 20 EStG als Kapitalertrag). Die spätere Veräußerung von Währungsguthaben aus Dividendenzuflüssen ist somit nie nach § 23 EStG steuerbar, weil es kein Anschaffungsgeschäft dazu gibt. Anschaffung = Erwerb von etwas Bestehendem von einem Dritten gegen Hingabe des Kaufpreises.
  • Abflüsse, die keine Veräußerung darstellen. Ich zähle dazu u.a. Kontogebühren, fremde Steuern, Zinsen etc. im Zusammenhang mit der Kapitalüberlassung

TODO

Important:

  • If a long option is assigned, the option buy price should be added to the stock price. This is currently not done, but we print a warning message for this case for manual adjustments in this rather rare case.
  • Currently all we only make one pass over the data. Better allow several data passes/computations.
  • Print header with explanation of transaction output.
  • Can Excel output also include yearly summary data computed from Excel? Can transactions also be grouped per year on different sheets?
  • Optionally break up report into: dividends, withholding-tax, interest, fees, stocks, other.
  • Does not work with futures.
  • Stock splits and spinoffs are not supported.
  • For currency gains, we could also add all fees as tax free by adding a separate booking/transaction.
  • In German: Stillhalterpraemien gelten auch nicht als Währungsanschaffung, sondern als Zufluss und sind daher steuer-neutral. Im Source wird dazu die Auszeichnung von Tastyworks als "Sell-To-Open" verwendet. Was passiert aber,wenn man eine Option gekauft hat und dann 2 davon verkauft? Bleibt das bei Tastyworks eine Transaktion oder finden hier dann zwei Transaktionen statt? Dieser Fall tritt bei mir nicht auf. Der Source Code sollte zumindest diesen Fall detektieren und eine Warnung ausgeben.
  • Complete support for Investmentsteuergesetz (InvStG) 2018.
  • Add images on how to download csv-file within Tastyworks into docu.
  • Complete the list of non-stocks.
  • Done: For an individual stock whitelist we could list all SP500 and Nasdaq100 stocks. How do we cope with historical data for this?
  • Specify non-realised gains to know how much tax needs to be paid for current net total.
  • Add performance reviews, graphs based on different time periods.
  • Add description of the asset: SPY: SPDR S&P 500 ETF Trust
  • Check if dates are truely ascending in the provided csv input files.
  • Check if withholding tax is max 15% for US stocks as per DBA. Warn if e.g. 30% withholding tax is paid and point to missing W8-BEN formular.
  • Are we rounding output correctly?
  • Is the time output correct with the correct timezone?
  • Does Tastyworks use BRK.B or BRK/B in transaction history? Adjust the list of individual stocks accordingly.

Nice:

  • Translate text output into German.
  • Add docu in German.
  • Add test data for users to try out.
  • Add testsuite to verify proper operation.
  • Improve output of open positions.
  • Use pandas.isna(x)?