pytrpp2: Trade Republic data exporter with Portfolio Performance support

This is a tool for the private API of the Trade Republic online brokerage. This package and its authors are not affiliated with Trade Republic Bank GmbH.

Credits and lineage

pytrpp2 builds on the work of two projects:

• pytr — the actively maintained Trade Republic API client that pytrpp2 forks. All core functionality (timeline download, document download, transaction export, price alarms, etc.) comes from pytr.
• pytrpp by Martin Scharrer — an earlier extension of pytr that pioneered Portfolio Performance CSV export for Trade Republic data. pytrpp appears to be inactive, so pytrpp2 picks up that work: the PP-specific conversion logic (export_pp, check_mappings) is ported and extended from pytrpp.

What pytrpp2 adds compared to pytr

pytrpp2 is a fork of pytr and includes all of its original functionality. On top of that, pytrpp2 adds three subcommands specifically for Portfolio Performance users:

The CSV format produced by export_pp matches exactly what Portfolio Performance expects:

• payments.csv → Account Transactions (deposits, withdrawals, card payments, dividends, interest, taxes, tax refunds)
• orders.csv → Portfolio Transactions (buys and sells incl. savings plans and round-ups, saveback and bonus shares, securities transfers, corporate actions)

Installation

Requires Python 3.10 or newer.

pip install pytrpp2

export_pp — Portfolio Performance export

Downloads your Trade Republic timeline and converts it to files ready to import into Portfolio Performance.

Quick start

# Export CSVs and event log into a directory:
pytrpp2 export_pp -n +49123456789 -p 1234 -D /path/to/output

# Also download PDF documents into a timestamped subfolder:
pytrpp2 export_pp -n +49123456789 -p 1234 -D /path/to/output -F /path/to/docs

# Incremental — only export events not exported by an earlier run:
pytrpp2 export_pp -n +49123456789 -p 1234 -D /path/to/output --incremental

Each run with -D creates a timestamped subfolder (YYYY-MM-DD_HH-MM-SS) inside the given directory. Pass --incremental to export only what earlier runs have not exported yet:

• Only completed runs count (folder contains events.json and a CSV). A run that failed, e.g. at login, does not move the start point forward.
• Events are re-fetched from 7 days before the most recent completed run. Trade Republic publishes some events after their timestamp, and this overlap also absorbs the UTC/local-time difference in the timeline filter.
• Events whose id already appears in an earlier run's events.json are skipped, so the overlap never creates duplicate transactions.

If no completed run is found, all events are fetched.

If phone number or PIN is omitted, pytrpp2 will prompt for them or read them from ~/.pytr/credentials (first line: phone number, second line: PIN).

Full argument reference

usage: pytrpp2 export_pp [-h] [-n PHONE_NO] [-p PIN] [--applogin]
                          [--waf-token WAF_TOKEN] [--store_credentials]
                          [-D DIR] [-E EVENTS_FILE] [-P PAYMENTS_FILE]
                          [-O ORDERS_FILE] [-F DOCS_DIR] [--workers WORKERS]
                          [--last_days DAYS] [--days_until DAYS]

Authentication:
  -n, --phone_no PHONE_NO       TradeRepublic phone number (international format)
  -p, --pin PIN                 TradeRepublic PIN
  --applogin                    Use app login instead of web login
  --waf-token WAF_TOKEN         Manually provide an aws-waf-token cookie value
  --store_credentials           Store credentials for next run

Output (use -D to set all at once, or specify individually):
  -D, --dir DIR                 Main output directory. Sets default paths for
                                events.json, payments.csv, and orders.csv.
                                Does NOT trigger PDF download — use -F for that.
  -E, --events-file FILE        Write raw event data to this JSON file
  -P, --payments-file FILE      Write payments (dividends, interest, etc.) to this CSV
  -O, --orders-file FILE        Write orders (buy/sell) to this CSV
  -F, --docs-dir DIR            Download PDF documents into this directory.
                                A timestamped subfolder (YYYY-MM-DD_HH-MM-SS) is
                                created automatically on each run.

Download options:
  --workers N                   Number of parallel download workers (default: 8)

Date range (both default to 0 = include everything):
  --last_days DAYS              Include only the last N days of data
  --days_until DAYS             Exclude the most recent N days (offset the end date)
  --incremental                 Only export events not exported by an earlier run
                                (requires -D). Re-fetches from 7 days before the last
                                completed run and skips already exported event ids.

Output files

events.json is written before the conversion starts, so the raw data is kept even if something goes wrong later.

How special cases are booked in orders.csv:

Cash events without any amount (e.g. a Vorabpauschale fully covered by the tax allowance, a 0,00 € dividend) produce no row and are counted as ignored.

Portfolio Performance cannot import splits or spin-offs as such; if you prefer to record them with PP's own corporate action dialogs, skip those rows during import.

After conversion, export_pp prints an event audit and the gap check (see check_mappings below).

check_mappings — Gap detector

Runs the same conversion as export_pp on an events JSON and reports every event that would be missing from payments.csv and orders.csv — typically caused by Trade Republic renaming or introducing event types after a platform update.

pytrpp2 check_mappings /path/to/events.json

Output:

• Event audit: events, converted (with order / payment row counts), ignored, unknown, errors
• WARNING with date, title, subtitle and id of every event that was not recognised or failed to convert — check these in the TR app and book them manually if needed
• Rows converted with parser warnings (e.g. share count could not be parsed) — verify these in PP
• Intentionally ignored types (account events, notifications, cancelled orders — expected)

export_pp runs this check automatically after every conversion, so you only need to call it manually to re-check an older events JSON.

Authentication

Authentication works the same as in pytr. See pytr's README for details on web login, app login, and the credentials file.

Development

See pytr's README for general setup, linting, and formatting instructions — the toolchain is identical (uv, ruff, mypy).

Clone and install this fork:

git clone https://github.com/JonathanWillnow/pytrpp2.git
cd pytrpp2
uv sync --group dev
uv run pytest

A pre-commit hook runs the full test suite automatically before every commit.

Bugs and contributing

For bugs or feature requests in the PP-specific functionality (export_pp, check_mappings), open an issue in this repository. For issues with core Trade Republic API behaviour, do not forget to report them upstream in pytr.

License

This project is licensed under the MIT License. See the LICENSE file for details.