Export To Ghostfolio
Release 0.19.1
該工具可讓您將多個交易匯出 (CSV) 轉換為 Ghostfolio 可以讀取的匯入檔案。目前支援：
比特瓦沃
布克斯
德吉羅
e投睿
芬蘭退休金
自由貿易
盈透證券（IBKR）
投資性
鑲木地板
荷蘭合作銀行
革命
施瓦布
瑞訊銀行
交易 212
XTB
您的經紀人不在名單中嗎？請隨意創建一個問題，或者更好的是，您自己建立它並創建拉取請求！有關更多信息，請參閱貢獻。
請參閱下面每個受支援經紀商的交易匯出說明。
登入您的 Bitvavo 帳戶並點擊右上角您的姓名。接下來，點選「交易紀錄」。按一下 處的藍色「匯出」按鈕以建立匯出。選擇 CSv 選項之一，然後再次按一下「匯出」。
打開應用程式並轉到“帳戶價值”，然後“查看歷史記錄”。點擊右上角的下載圖示可下載您的交易記錄。匯出的內容將發送到您的電子郵件地址。
由於 BUX 的限制，您每天最多可以請求 3 個 CSV 匯出！ 。
登入您的 DEGIRO 帳戶並建立匯出檔案（透過“收件匣”>“帳戶概覽”，請參閱下圖）。選擇您想要匯出歷史記錄的時間段，然後按一下下載。
登入您的 eToro 帳戶並導航至「投資組合」。然後在頂部選單中選擇“歷史記錄”。接下來，點擊最右側的圖示並選擇“帳戶對帳單”。選擇感興趣的日期並點擊“建立”。在下一頁上，按一下右上角的 Excel 圖示下載檔案。下載後，在 Excel 中開啟檔案並刪除除「帳戶活動」標籤之外的所有標籤。然後使用 Excel 將文件轉換為 CSV。
登入您的 Finpension 帳戶。從登陸頁面選擇您的作品集。然後在螢幕右側選擇“交易”，在下一頁右側注意“交易報告（CSV 檔案）”，然後點擊透過電子郵件發送或點擊本地下載。
打開自由貿易應用程式。從左上角「投資組合」標題下的選項中選擇您的投資組合。從螢幕底部的圖示清單中選擇“活動”。選擇右上角的共用圖標，然後按照螢幕上的指示進行操作。
登入您的盈透證券帳戶。導覽至“帳戶管理”，然後按一下側邊欄中的“報表”。接下來，按一下「報告」部分中的「Flex Queries」標籤。在 Flex「查詢部分」中，按一下右側的加號 (+) 圖示以建立新的 Flex 查詢。為交易建立一個新的靈活查詢，為股息建立另一個靈活查詢。將匯出格式設定為“CSV”。請參閱圖像下方所需的列。
對於交易，選擇“交易”。然後選擇以下屬性： Buy/Sell, TradeDate, ISIN, Quantity, TradePrice, TradeMoney, CurrencyPrimary, IBCommission, IBCommissionCurrency 。
對於股息，選擇“現金交易”。然後選擇以下屬性： Type, SettleDate, ISIN, Description, Amount, CurrencyPrimary 。
登入您的投資帳戶並點擊「訂單每日日誌」。選擇帳戶和所需的時間段，然後按一下刷新按鈕。交易應該會出現，然後點擊下載按鈕。
登入 Parquet 並導航至「活動」部分（德語為「Aktivitäten」）。在右上角綠色的“Neue Aktivität”按鈕旁邊，您會看到“下載為 CSV”選項（德語為“匯出 CSV”）。按一下此按鈕下載包含您所有活動的 CSV 檔案。
登入荷蘭合作銀行並導航到您的投資。導航至「交易和合約票據」（Mutaties & Nota's）。在頂部選擇您要匯出的範圍。然後滾動到頁面底部並點擊“匯出為.csv”
打開 Revolut 應用程式並開啟「投資」標籤。按下“更多”按鈕，然後選擇“文件”。選擇您的投資帳戶，然後選擇第一個選項「帳戶對帳單」。選擇“Excel”選項並選擇日期範圍。然後下載該檔案並將其保存在您的裝置上。將檔案從.xlsx轉換為.csv 。將分隔符號設為, （逗號）！
登入您的嘉信理財帳戶。前往“帳戶”，然後前往“歷史記錄”。選擇您要從中下載詳細資訊的帳戶。選擇「日期範圍」並選擇「匯出」(csv)。儲存文件。
登入您的瑞訊帳號。從列選單中點選“交易”。選擇所需的時間段和類型，然後選擇右側的「匯出 CSV」按鈕。
登入您的 Trading 212 帳戶並建立匯出檔案（透過「歷史記錄」>「下載」圖示）。選擇您想要匯出歷史記錄的時間段，然後按一下下載。
登入您的 XTB 帳戶，然後從頂部欄中按一下“帳戶歷史記錄”，然後按一下“現金操作”。點選“匯出按鈕”。選擇您要匯出歷史記錄的時間段，選擇報表類型“現金業務”，選擇檔案格式“csv”，然後按一下“匯出報表”按鈕。
您可以透過複製此儲存庫在本機電腦上執行該工具。您也可以在 Docker 容器內執行該工具。請參閱下面的運行時特定說明。
要執行 Docker 容器，您需要在電腦上安裝 Docker。該映像已發佈到 Docker Hub。
與該工具的本機運行版本相反，容器化版本嘗試透過查看文件內的標題行來確定要處理的文件類型。因此無需指定使用哪個轉換器。
然後您可以運行該圖像，如下所示：
docker run --rm -v {local_in-folder}:/var/tmp/e2g-input -v {local_out_folder}:/var/tmp/e2g-output --env GHOSTFOLIO_ACCOUNT_ID=xxxxxxx dickwolff/export-to-ghostfolio可以將下列參數傳遞給 Docker run 命令。
| 命令 | 選修的 | 描述 |
|---|---|---|
-v {local_in-folder}:/var/tmp/e2g-input | 氮 | 放置要處理的檔案的輸入資料夾 |
-v {local_out_folder}:/var/tmp/e2g-output | 氮 | 將放置 Ghostfolio 導入 JSON 的輸出資料夾。當處理文件時發生錯誤時，輸入文件也會移至此處。 |
-v {local_cache_folder}:/var/tmp/e2g-cache | 是 | 將緩存雅虎財經符號的資料夾 |
--env GHOSTFOLIO_ACCOUNT_ID=xxxxxxx | 氮 | 您的 Ghostolio 帳號 ID 1 |
--env USE_POLLING=true | 是 | 當設定為 true 時，容器將不斷尋找新檔案來處理，並且容器不會停止。 |
--env DEBUG_LOGGING=true | 是 | 當設定為 true 時，容器將顯示更詳細的日誌，這對於錯誤追蹤很有用。 |
--env PURGE_CACHE=true | 是 | 當設定為 true 時，檔案快取將在啟動時清除。 |
--env GHOSTFOLIO_VALIDATE=true | 是 | 當設定為 true 時，該工具會自動根據 Ghostfolio 驗證產生的檔案。 |
--env GHOSTFOLIO_IMPORT=true | 是 | 當設定為 true 時，該工具將嘗試自動將生成的檔案匯入 Ghostfolio。 |
--env GHOSTFOLIO_URL=http://xxxxxxx | 是 | 本機Ghostfolio 實例的端點。例如http://192.168.1.15:3333 。僅與本地 Ghostfolio 實例一起使用！ |
--env GHOSTFOLIO_SECRET=xxxxxxx | 是 | 您的 Ghostfolio 使用者的憑證。用於透過import API 端點進行身份驗證。僅與本地 Ghostfolio 實例一起使用！ |
如果您希望使用隔離的 docker 環境運行，在該環境中您可以完全控制映像，因此可以相信它只包含預期的內容，請使用此選項。
將此存儲庫克隆到您的系統，然後運行：
docker build -t 匯出到 Ghostfolio .docker run --rm -v {local_in-folder}:/var/tmp/e2g-input -v {local_out_folder}:/var/tmp/e2g-output --env GHOS t 匯出到Ghostfolio您可以使用與上面相同的選項在 Dockerhub 上使用映像
該工具使用cacache將從 Yahoo Finance 檢索到的資料儲存在容器內。這樣，雅虎財經的負載就會減少，而且該工具應該會運行得更快。快取的資料儲存在容器內的/var/tmp/e2g-cache中。如果您覺得需要讓快取失效，可以透過在執行指令中加入--env PURGE_CACHE=true來實現。這將在容器啟動時清除緩存，並且該工具將在下次必須從雅虎財經檢索資料時重新建立快取。
該工具要求您安裝最新的 LTS 版本的 Node，您可以在此處下載。該工具可以在任何可以安裝 Node.js 的作業系統上運行。
接下來，將儲存庫複製到本機電腦並使用您選擇的編輯器（例如 Visual Studio Code）開啟。
運行npm install以安裝所有必要的套件。
該存儲庫包含一個示例.env檔。將其從.env.sample重命名。
將匯出檔案路徑放入INPUT_FILE變數中。這必須與項目的根相關。
將 Ghostfolio 帳號名稱放入GHOSTFOLIO_ACCOUNT_ID中您希望交易結束的位置
可以透過前往帳戶 > 選擇您的帳戶並從 URL 複製 ID 來檢索此訊息
您也可以選擇將GHOSTFOLIO_UPDATE_CASH變數設定為TRUE以便在處理活動後自動更新您的 Ghostfolio 帳戶現金餘額。
您可以選擇將DEBUG_LOGGING變數設為TRUE來啟用偵錯日誌記錄。
現在您可以執行npm run start [exporttype] 。請參閱下面的運行命令表。該工具將打開您的導出並將其轉換。它檢索 YAHOO Finance 支援的符號（例如，對於ASML等歐洲股票，它將透過相應的 ISIN 檢索ASML.AS ）。
| 出口商 | 運行命令 |
|---|---|
| 比特瓦沃 | run start bitvavo （或bv ） |
| 布克斯 | run start bux |
| 德吉羅 | run start degiro |
| e投睿 | run start etoro |
| 芬蘭退休金 | run start finpension （或fp ） |
| 自由貿易 | run start freetrade （或ft ） |
| IBKR | run start ibkr |
| 投資性 | run start investimental |
| 鑲木地板 | run start pareqt |
| 荷蘭合作銀行 | run start rabobank |
| 革命 | run start revolut |
| 施瓦布 | run start schwab |
| 瑞訊銀行 | run start swissquote （或sq ） |
| 交易 212 | run start trading212 （或t212 ） |
| XTB | run start xtb |
該工具使用cacache將從雅虎財經檢索到的資料儲存在磁碟上。這樣，雅虎財經的負載就會減少，而且該工具應該會運行得更快。快取的資料儲存在/var/tmp/e2g-cache中。如果您覺得需要使快取失效，可以透過刪除資料夾來實現，該工具將在您下次執行時重新建立快取。
現在可以透過前往「Portfolio」>「Activities」並按表格右上角的 3 個點，將匯出檔案匯入 Ghostfolio 中。從 Ghostfolio 1.221.0 開始，您現在可以預覽導入並驗證資料是否已正確轉換。如果您滿意，請按匯入將活動新增至您的作品集。
有一個實驗性功能（自 0.12.0 起），您可以使用該功能自動驗證生成的檔案並將其匯入 Ghostfolio！要使用它，請設定相應的環境變數：
| 多變的 | 描述 |
|---|---|
--env GHOSTFOLIO_VALIDATE=true | 當設定為 true 時，該工具會自動根據 Ghostfolio 驗證產生的檔案。 |
--env GHOSTFOLIO_IMPORT=true | 當設定為 true 時，該工具將嘗試自動將生成的檔案匯入 Ghostfolio。 |
--env GHOSTFOLIO_URL=http://xxxxxxx | 本機Ghostfolio 實例的端點。例如http://192.168.1.15:3333 。僅與本地 Ghostfolio 實例一起使用！ |
--env GHOSTFOLIO_SECRET=xxxxxxx | 您的 Ghostfolio 使用者的憑證。用於透過import API 端點進行身份驗證。僅與本地 Ghostfolio 實例一起使用！ |
我們歡迎對儲存庫的任何貢獻。請隨意創建一個問題，或者更好的是，您自己建立它並創建拉取請求！
該工具可以透過兩種方式運行：手動運行和透過 Docker 運行。該工具的兩個入口點都可以在“src/”資料夾中找到。該工具在測試中使用模擬，這使得測試能夠以一致且可重複的方式運行。這樣就不需要雅虎財經服務了。新增模擬是因為測試運行之間的不一致以及雅虎財經的速率限制問題（多次連續運行，尤其是在本地運行時）。
每當您新增轉換器或為現有轉換器建立修復程式時，請參閱 Wiki 以取得有關如何使用測試資料擴充模擬的說明。
您可以透過前往帳戶 > 編輯您的帳戶並複製帳戶 ID 欄位來擷取 Ghostfolio 帳戶 ID ↩
