Mit diesem Tool können Sie mehrere Transaktionsexporte (CSV) in eine Importdatei konvertieren, die von Ghostfolio gelesen werden kann. Derzeit gibt es Unterstützung für:
Bitvavo
BUX
DEGIRO
eToro
Finpension
Freihandel
Interaktive Broker (IBKR)
Investiv
Parkett
Rabobank
Revolut
Schwab
Swissquote
Handel 212
XTB
Ist Ihr Broker nicht in der Liste? Fühlen Sie sich frei, ein Issue zu erstellen oder, noch besser, es selbst zu erstellen und eine Pull-Anfrage zu erstellen! Weitere Informationen finden Sie unter „Mitwirken“.
Nachfolgend finden Sie die Anweisungen zum Transaktionsexport für jeden der unterstützten Broker.
Melden Sie sich bei Ihrem Bitvavo-Konto an und klicken Sie oben rechts auf Ihren Namen. Klicken Sie anschließend auf „Transaktionsverlauf“. Klicken Sie auf die blaue Schaltfläche „Exportieren“, um einen Export zu erstellen. Wählen Sie eine der CSV-Optionen und klicken Sie erneut auf „Exportieren“.
Öffnen Sie die App und gehen Sie zu „Kontowert“ und dann zu „Verlauf anzeigen“. Klicken Sie oben rechts auf das Download-Symbol, um Ihren Transaktionsverlauf herunterzuladen. Der Export wird an Ihre E-Mail-Adresse gesendet.
Aufgrund von Einschränkungen durch BUX können Sie bis zu 3 CSV-Exporte pro Tag anfordern! .
Melden Sie sich bei Ihrem DEGIRO-Konto an und erstellen Sie eine Exportdatei (über Posteingang > Kontoübersicht, siehe Abbildung unten). Wählen Sie den Zeitraum aus, aus dem Sie Ihren Verlauf exportieren möchten, und klicken Sie auf „Herunterladen“.
Melden Sie sich bei Ihrem eToro-Konto an und navigieren Sie zu „Portfolio“. Wählen Sie dann im oberen Menü „Verlauf“ aus. Klicken Sie anschließend auf das Symbol ganz rechts und wählen Sie „Kontoauszug“. Wählen Sie die gewünschten Daten aus und klicken Sie auf „Erstellen“. Klicken Sie auf der nächsten Seite oben rechts auf das Excel-Symbol, um die Datei herunterzuladen. Öffnen Sie nach dem Herunterladen die Datei in Excel und löschen Sie alle Registerkarten außer der Registerkarte „Kontoaktivität“. Verwenden Sie dann Excel, um die Datei in CSV zu konvertieren.
Melden Sie sich bei Ihrem Finpension-Konto an. Wählen Sie Ihr Portfolio auf der Zielseite aus. Wählen Sie dann rechts auf dem Bildschirm „Transaktionen“, auf der folgenden Seite rechts „Transaktionsbericht (CSV-Datei)“ und klicken Sie auf „E-Mail senden“ oder klicken Sie auf „Lokal herunterladen“.
Öffnen Sie die Freetrade-App. Wählen Sie Ihr Portfolio aus der Option oben links unter der Überschrift „Portfolio“ aus. Wählen Sie „Aktivität“ aus der Liste der Symbole am unteren Bildschirmrand. Wählen Sie das Teilen-Symbol in der oberen rechten Ecke aus und befolgen Sie dann die Anweisungen auf dem Bildschirm.
Melden Sie sich bei Ihrem Interactive Brokers-Konto an. Navigieren Sie zur Kontoverwaltung und klicken Sie in der Seitenleiste auf „Berichterstellung“. Klicken Sie anschließend im Abschnitt „Reporting“ auf die Registerkarte „Flex Queries“. Klicken Sie im Flex-Abschnitt „Abfragen“ auf das Pluszeichen (+) auf der rechten Seite, um eine neue Flex-Abfrage zu erstellen. Erstellen Sie eine neue Flex-Abfrage für Trades und eine weitere für Dividenden. Stellen Sie das Exportformat auf „CSV“ ein. Sehen Sie sich die erforderlichen Spalten unter dem Bild an.
Wählen Sie für Trades „Trades“ aus. Wählen Sie dann die folgenden Eigenschaften aus: Buy/Sell, TradeDate, ISIN, Quantity, TradePrice, TradeMoney, CurrencyPrimary, IBCommission, IBCommissionCurrency
.
Wählen Sie für Dividenden „Bartransaktionen“ aus. Wählen Sie dann die folgenden Eigenschaften aus: Type, SettleDate, ISIN, Description, Amount, CurrencyPrimary
.
Melden Sie sich bei Ihrem Investmentkonto an und klicken Sie auf „Tagesprotokoll der Bestellungen“. Wählen Sie das Konto und den gewünschten Zeitraum aus und klicken Sie dann auf die Schaltfläche „Aktualisieren“. Transaktionen sollten angezeigt werden. Klicken Sie dann auf die Schaltfläche zum Herunterladen.
Melden Sie sich bei Parquet an und navigieren Sie zum Abschnitt „Aktivitäten“. In der oberen rechten Ecke sehen Sie neben der grünen Schaltfläche „Neue Aktivität“ die Option „Als CSV herunterladen“ (auf Deutsch „Als CSV exportieren“). Klicken Sie auf diese Schaltfläche, um eine CSV-Datei herunterzuladen, die alle Ihre Aktivitäten enthält.
Melden Sie sich bei der Rabobank an und navigieren Sie zu Ihren Investitionen. Navigieren Sie zu „Transaktionen und Vertragsnotizen“ (Mutaties & Nota's). Wählen Sie oben den Bereich aus, den Sie exportieren möchten. Scrollen Sie dann zum Ende der Seite und klicken Sie auf „Als .csv exportieren“.
Öffnen Sie die Revolut-App und öffnen Sie den „Invest“-Tab. Klicken Sie auf die Schaltfläche „Mehr“ und wählen Sie dann „Dokumente“. Wählen Sie Ihr Anlagekonto aus und wählen Sie die erste Option „Kontoauszug“. Wählen Sie die Option „Excel“ und wählen Sie den Datumsbereich aus. Laden Sie dann die Datei herunter und speichern Sie sie auf Ihrem Gerät. Konvertieren Sie die Datei von .xlsx
in .csv
. Setzen Sie das Trennzeichen auf ,
(Komma)!
Melden Sie sich bei Ihrem Schwab-Konto an. Gehen Sie zu „Konten“ und dann zu „Verlauf“. Wählen Sie das Konto aus, von dem Sie Details herunterladen möchten. Wählen Sie den „Datumsbereich“ und dann „Exportieren“ (csv). Speichern Sie die Datei.
Melden Sie sich bei Ihrem Swissquote-Konto an. Klicken Sie im Leistenmenü auf „Transaktionen“. Wählen Sie den gewünschten Zeitraum sowie die gewünschten Typen aus und klicken Sie dann rechts auf die Schaltfläche „CSV exportieren“.
Melden Sie sich bei Ihrem Trading 212-Konto an und erstellen Sie eine Exportdatei (über Verlauf > Download-Symbol). Wählen Sie den Zeitraum aus, aus dem Sie Ihren Verlauf exportieren möchten, und klicken Sie auf „Herunterladen“.
Melden Sie sich bei Ihrem XTB-Konto an und klicken Sie in der oberen Leiste auf „Kontoverlauf“ und dann auf „Bargeldtransaktionen“. Klicken Sie auf die Schaltfläche „Exportieren“. Wählen Sie den Zeitraum aus, aus dem Sie Ihre Historie exportieren möchten, wählen Sie den Berichtstyp „Cash Operations“ aus, wählen Sie das Dateiformat „csv“ und klicken Sie dann auf die Schaltfläche „Bericht exportieren“.
Sie können das Tool auf Ihrem lokalen Computer ausführen, indem Sie dieses Repository klonen. Sie können das Tool auch in einem Docker-Container ausführen. Siehe die laufzeitspezifischen Anweisungen unten.
Um den Docker-Container auszuführen, muss Docker auf Ihrem Computer installiert sein. Das Bild wird im Docker Hub veröffentlicht.
Im Gegensatz zur lokal ausgeführten Version des Tools versucht die Containerversion anhand der Kopfzeile in der Datei zu ermitteln, welcher Dateityp verarbeitet werden soll. Es ist also nicht erforderlich, den zu verwendenden Konverter anzugeben.
Sie können das Image dann wie folgt ausführen:
docker run --rm -v {local_in-folder}:/var/tmp/e2g-input -v {local_out_folder}:/var/tmp/e2g-output --env GHOOSTFOLIO_ACCOUNT_ID=xxxxxxx dickwolff/export-to-ghostfolio
Die folgenden Parameter können dem Docker-Ausführungsbefehl übergeben werden.
Befehl | Optional | Beschreibung |
---|---|---|
-v {local_in-folder}:/var/tmp/e2g-input | N | Der Eingabeordner, in dem Sie die zu verarbeitenden Dateien ablegen |
-v {local_out_folder}:/var/tmp/e2g-output | N | Der Ausgabeordner, in dem der Ghostfolio-Import-JSON abgelegt wird. Außerdem wird die Eingabedatei hierher verschoben, wenn bei der Verarbeitung der Datei ein Fehler aufgetreten ist. |
-v {local_cache_folder}:/var/tmp/e2g-cache | Y | Der Ordner, in dem Yahoo Finance-Symbole zwischengespeichert werden |
--env GHOSTFOLIO_ACCOUNT_ID=xxxxxxx | N | Ihre Ghostolio-Konto-ID 1 |
--env USE_POLLING=true | Y | Wenn der Wert auf „true“ gesetzt ist, sucht der Container kontinuierlich nach neuen zu verarbeitenden Dateien und stoppt nicht. |
--env DEBUG_LOGGING=true | Y | Wenn der Wert auf „true“ gesetzt ist, zeigt der Container die Protokolle detaillierter an, was für die Fehlerverfolgung nützlich ist. |
--env PURGE_CACHE=true | Y | Wenn der Wert auf „true“ gesetzt ist, wird der Dateicache beim Start geleert. |
--env GHOSTFOLIO_VALIDATE=true | Y | Wenn der Wert auf „true“ gesetzt ist, validiert das Tool die generierte Datei automatisch anhand von Ghostfolio. |
--env GHOSTFOLIO_IMPORT=true | Y | Bei „true“ versucht das Tool, die generierte Datei automatisch in Ghostfolio zu importieren. |
--env GHOSTFOLIO_URL=http://xxxxxxx | Y | Der Endpunkt Ihrer lokalen Ghostfolio-Instanz. ZB http://192.168.1.15:3333 . NUR mit einer lokalen Ghostfolio-Instanz verwenden! |
--env GHOSTFOLIO_SECRET=xxxxxxx | Y | Die Anmeldeinformationen Ihres Ghostfolio-Benutzers. Wird zur Authentifizierung beim import -API-Endpunkt verwendet. NUR mit einer lokalen Ghostfolio-Instanz verwenden! |
Verwenden Sie diese Option, wenn Sie eine isolierte Docker-Umgebung verwenden möchten, in der Sie die volle Kontrolle über das Image haben und daher darauf vertrauen können, dass es nur das enthält, was erwartet wird.
Klonen Sie dieses Repository auf Ihr System und führen Sie dann Folgendes aus:
docker build -t export-to-ghostfolio .docker run --rm -v {local_in-folder}:/var/tmp/e2g-input -v {local_out_folder}:/var/tmp/e2g-output --env GHOSTFOLIO_ACCOUNT_ID= xxxxxxx -t export-to-ghostfolio
Sie können die gleichen Optionen wie oben für die Verwendung des Bildes auf Dockerhub verwenden
Das Tool verwendet cacache
um von Yahoo Finance abgerufene Daten im Container zu speichern. Dadurch wird die Belastung von Yahoo Finance reduziert und das Tool sollte schneller laufen. Die zwischengespeicherten Daten werden im Container in /var/tmp/e2g-cache
gespeichert. Wenn Sie das Gefühl haben, dass Sie Ihren Cache ungültig machen müssen, können Sie dies tun, indem Sie --env PURGE_CACHE=true
zu Ihrem Ausführungsbefehl hinzufügen. Dadurch wird der Cache beim Start des Containers geleert und das Tool erstellt den Cache neu, wenn es das nächste Mal Daten von Yahoo Finance abrufen muss.
Für das Tool müssen Sie die neueste LTS-Version von Node installieren, die Sie hier herunterladen können. Das Tool kann auf jedem Betriebssystem ausgeführt werden, auf dem Sie Node installieren können.
Klonen Sie als Nächstes das Repo auf Ihren lokalen Computer und öffnen Sie es mit dem Editor Ihrer Wahl (z. B. Visual Studio Code).
Führen Sie npm install
aus, um alle erforderlichen Pakete zu installieren.
Das Repository enthält eine Beispiel .env
Datei. Benennen Sie dies von .env.sample
um.
Geben Sie den Pfad Ihrer Exportdatei in die Variable INPUT_FILE
ein. Dies muss relativ zum Stammverzeichnis des Projekts sein.
Geben Sie in GHOSTFOLIO_ACCOUNT_ID
den Namen des Ghostfolio-Kontos ein, auf dem Ihre Transaktionen enden sollen
Dies können Sie abrufen, indem Sie zu „Konten“ gehen > Ihr Konto auswählen und die ID von der URL kopieren
Optional können Sie die Variable GHOSTFOLIO_UPDATE_CASH
auf TRUE
setzen, um den Barguthaben Ihres Ghostfolio-Kontos nach der Verarbeitung der Aktivitäten automatisch zu aktualisieren.
Optional können Sie die Debug-Protokollierung aktivieren, indem Sie die Variable DEBUG_LOGGING
auf TRUE
setzen.
Sie können jetzt npm run start [exporttype]
ausführen. Siehe die Tabelle mit den Ausführungsbefehlen unten. Das Tool öffnet Ihren Export und konvertiert ihn. Es ruft die Symbole ab, die von YAHOO Finance unterstützt werden (z. B. wird für europäische Aktien wie ASML
ASML.AS
anhand der entsprechenden ISIN abgerufen).
Exporteur | Befehl ausführen |
---|---|
Bitvavo | run start bitvavo (oder bv ) |
BUX | run start bux |
DEGIRO | run start degiro |
eToro | run start etoro |
Finpension | run start finpension (oder fp ) |
Freihandel | run start freetrade (oder ft ) |
IBKR | run start ibkr |
Investiv | run start investimental |
Parkett | run start pareqt |
Rabobank | run start rabobank |
Revolut | run start revolut |
Schwab | run start schwab |
Swissquote | run start swissquote (oder sq ) |
Handel 212 | run start trading212 (oder t212 ) |
XTB | run start xtb |
Das Tool verwendet cacache
um von Yahoo Finance abgerufene Daten auf der Festplatte zu speichern. Dadurch wird die Belastung von Yahoo Finance reduziert und das Tool sollte schneller laufen. Die zwischengespeicherten Daten werden in /var/tmp/e2g-cache
gespeichert. Wenn Sie der Meinung sind, dass Sie Ihren Cache ungültig machen müssen, können Sie dies tun, indem Sie den Ordner entfernen. Das Tool erstellt dann den Cache neu, wenn Sie es das nächste Mal ausführen.
Die Exportdatei kann nun in Ghostfolio importiert werden, indem Sie zu Portfolio > Aktivitäten gehen und auf die 3 Punkte oben rechts in der Tabelle klicken. Seit Ghostfolio 1.221.0 können Sie nun eine Vorschau des Imports anzeigen und überprüfen, ob die Daten korrekt konvertiert wurden. Wenn Sie zufrieden sind, klicken Sie auf „Importieren“, um die Aktivitäten zu Ihrem Portfolio hinzuzufügen.
Es gibt eine experimentelle Funktion (seit 0.12.0), mit der Sie die generierte Datei automatisch validieren und in Ghostfolio importieren können! Um dies zu nutzen, legen Sie die entsprechenden Umgebungsvariablen fest:
Variable | Beschreibung |
---|---|
--env GHOSTFOLIO_VALIDATE=true | Wenn der Wert auf „true“ gesetzt ist, validiert das Tool die generierte Datei automatisch anhand von Ghostfolio. |
--env GHOSTFOLIO_IMPORT=true | Bei „true“ versucht das Tool, die generierte Datei automatisch in Ghostfolio zu importieren. |
--env GHOSTFOLIO_URL=http://xxxxxxx | Der Endpunkt Ihrer lokalen Ghostfolio-Instanz. ZB http://192.168.1.15:3333 . NUR mit einer lokalen Ghostfolio-Instanz verwenden! |
--env GHOSTFOLIO_SECRET=xxxxxxx | Die Anmeldeinformationen Ihres Ghostfolio-Benutzers. Wird zur Authentifizierung beim import -API-Endpunkt verwendet. NUR mit einer lokalen Ghostfolio-Instanz verwenden! |
Wir freuen uns über jeden Beitrag zum Repositorium. Fühlen Sie sich frei, ein Issue zu erstellen oder, noch besser, es selbst zu erstellen und eine Pull-Anfrage zu erstellen!
Das Tool kann auf zwei Arten ausgeführt werden: manuell und über Docker. Beide Einstiegspunkte des Tools finden Sie im Ordner „src/“. Das Tool verwendet in den Tests ein Mock, wodurch die Tests auf konsistente und wiederholbare Weise ausgeführt werden können. Auf diese Weise besteht keine Notwendigkeit für einen Live-Dienst von Yahoo Finance. Der Mock wurde aufgrund von Inkonsistenzen zwischen den Testläufen und Ratenbegrenzungsproblemen bei Yahoo Finance (bei mehreren aufeinanderfolgenden Läufen, insbesondere bei lokaler Ausführung) hinzugefügt.
Wenn Sie einen neuen Konverter hinzufügen oder einen Fix für einen vorhandenen Konverter erstellen, lesen Sie bitte im Wiki nach, wie Sie den Mock mit Testdaten erweitern können.
Sie können Ihre Ghostfolio-Konto-ID abrufen, indem Sie für Ihr Konto zu Konten > Bearbeiten gehen und das Feld „Konto-ID“ kopieren ↩