Interactive Brokers

Interactive Brokers

從 Activity 或 Trade Confirmation Flex Query CSV 檔案匯入股票、ETF，以及由 Broker 標記的 Forex 成交。Tradeways 會先合併年度檔案，再建立 Trade。系統會分開保留部分成交，並使用 Interactive Brokers 成交 ID 偵測重複紀錄。

建立 Activity Flex Query

使用 Activity Flex Query，即可連同成交一起匯入 Broker 回報的已實現 P&L。

1. 登入 Interactive Brokers Client Portal，開啟Performance & Reports，再開啟Flex Queries。
2. 建立 Activity Flex Query。在德文版入口網站中，請選擇 Kontoumsatz-Flex-Query，而不是 Handelsbestätigungs-Flex-Query。
3. 新增 Trades 區段，選擇 Executions，並選取所有可用欄位。你也可以選取 Closed Lots，Tradeways 會忽略這些資料列，以免重複計算成交和 P&L。
4. 將 Profit and Loss 保持為 Default/Standard。請勿為這份匯出檔啟用基準貨幣 P&L。
5. 日期格式使用 yyyyMMdd，時間格式使用 HHmmss，並以分號分隔日期與時間。
6. 選擇 CSV 並保留欄位標題。分別匯出每個可用年度，再一起上傳所有檔案。

Activity 匯出檔會以 IBOrderID、IBExecID、DateTime、TradePrice、IBCommission、IBCommissionCurrency 和 Notes/Codes 取代下方對應的 Trade Confirmation 欄位。此外，檔案也必須包含 Open/CloseIndicator。FifoPnlRealized 為選填欄位，可提供已實現 P&L 供核對。系統不會將 MTM P&L 當作已實現 Trade P&L。

Broker 回報的已實現 P&L 已包含佣金。Tradeways 會將其與計算所得的 P&L 比較，但不會取代計算結果，也不會建立可手動編輯的 P&L 紀錄。重新匯入交易日誌中已有的成交，不會回填其 Broker P&L。

新增 Open Positions 以顯示浮動 P&L

在同一個 Activity Flex Query 中新增 Open Positions 區段，即可顯示未平倉部位的浮動 P&L。

1. 編輯 Activity Flex Query，新增 Open Positions 區段。
2. 將詳細程度選為 Summary，並選取所有可用欄位。
3. 按照先前的方式匯出查詢。之後每個檔案都會包含該期間結束時的未平倉部位。

Tradeways 會讀取 ClientAccountID、CurrencyPrimary、AssetClass、Symbol、Conid、ReportDate、Quantity、MarkPrice、Side 和 LevelOfDetail。FifoPnlUnrealized 為選填欄位。

浮動 P&L 會依 Interactive Brokers 在報表日期的收盤價（MarkPrice）計算，而非即時報價。Tradeways 會以該價格計算交易日誌中 Trade 未平倉數量的價值，並將報表日期顯示為「截至」日期。Interactive Brokers 回報的未實現 P&L 只會儲存供比較。帳戶餘額包含浮動 P&L。日曆、勝率及其他統計資料只會計入已平倉的 Trade。

上傳多個年度檔案時，Tradeways 會採用最新的報表日期。最新檔案中沒有的部位會視為已平倉。Tradeways 會依合約 ID 追蹤部位，因此即使代碼變更，該部位仍能與其 Trade 配對。

日後若要更新浮動 P&L，請再次匯出查詢並上傳最新檔案。即使所有成交都已存在交易日誌中，仍可透過此方式更新。目前僅支援股票和 ETF 部位。系統會略過其他部位資料列並顯示通知；無效的部位資料列會回報錯誤，但不會阻止匯入檔案中的成交。

建立 Trade Confirmation Flex Query

1. 登入 Interactive Brokers Client Portal。
2. 開啟Performance & Reports，再開啟Flex Queries。
3. 建立 Trade Confirmation Flex Query。
4. 選取所有可用的 Trade Confirmation 欄位。
5. 將日期格式設為 yyyyMMdd。
6. 將時間格式設為 HHmmss。
7. 將日期與時間分隔符號設為分號。
8. 將輸出格式設為 CSV。
9. 對每個可用年度執行查詢並下載所有檔案。

保留原始欄位名稱。Tradeways 可接受額外選取的欄位。

上傳至 Tradeways

1. 在 Trade 紀錄中，點擊新增 Trade，再點擊檔案上傳。
2. 在檔案時區下，選擇報表使用的時區。檔案不包含時區。
3. 在一次上傳中選擇所有年度 CSV 檔案。
4. 如果檔案包含多個 Interactive Brokers 帳戶，請將每個帳戶對應至一個 Tradeways 帳戶。單一來源帳戶會匯入目前的 Tradeways 帳戶。
5. 檢查每個帳戶的預覽。
6. 確認匯入。

Tradeways 會從版面格式辨識此匯出檔，並以本頁的規則讀取。沒有此版面格式的檔案會被視為未知格式讀取：Tradeways 會對應其欄位，而本頁的規則不適用。請參閱匯入 Trade。

一個 Interactive Brokers 檔案可以包含多個帳戶。多個年度檔案也可能重疊。Tradeways 會在預覽前移除重複的成交 ID。每個納入的來源帳戶都需要不同的 Tradeways 目的地帳戶。

檔案要求

• 使用 Activity 或 Trade Confirmation Flex Query CSV 檔案。不支援 XML。
• Tradeways 支援股票和 ETF 的 STK 資料列。
• 只有當 Interactive Brokers 將 CASH 資料列標記為開倉或平倉 Forex Trade 時，Tradeways 才會匯入這些資料列。
• Tradeways 不會將 AutoFX、現金清理及未標記的貨幣轉換資料列納入交易日誌。
• 此匯入不支援選擇權、期貨、債券、CFD、加密貨幣及未知資產代碼。
• Trade Confirmation 查詢必須包含以下欄位：ClientAccountID、CurrencyPrimary、AssetClass、Symbol、Conid、TradeID、OrderID、ExecID、Date/Time、Buy/Sell、Quantity、Price、Commission、CommissionCurrency、Code 和 LevelOfDetail。Activity 查詢使用上方列出的替代欄位。缺少任何欄位都會導致檔案無法匯入，錯誤訊息會列出缺少的欄位。
• 系統會略過 Trades 區段中的摘要資料列。
• Open Positions 區段為選填。系統會略過 Activity Flex Query 的其他區段，並將其回報為已略過的資料列。
• 不支援的資產類別會在寫入任何 Trade 前封鎖其來源帳戶。

報表時區適用於檔案中的每個帳戶。Tradeways 會在預覽前將所有成交時間轉換為 UTC。

Tradeways 會使用 Interactive Brokers 合約 ID，在標的的交易所代碼變更時繼續追蹤該標的。如果所選檔案和交易日誌都不包含先前的開倉成交，平倉成交會封鎖其來源帳戶。請新增較早的年度檔案，不要將賣出匯入為新的 Short 部位。交易日誌中已有的平倉成交不會造成封鎖，因此你可以只上傳最新的年度檔案。

如果缺少開倉歷史紀錄，系統會返回檔案選擇步驟。已選擇的檔案會保留。新增較早的年度匯出檔案，Tradeways 會再次檢查完整檔案組。你可以在繼續前移除任何已選擇的檔案。如果有多個來源帳戶，Tradeways 會在帳戶對應後，分別根據各帳戶的目的地進行檢查。

如果報表不包含開倉或平倉代碼，Tradeways 也會封鎖股票成交。系統不會猜測賣出是否為 Short 部位。即使取消紀錄出現在另一個已選擇的檔案中，已取消的成交也會被移除。

你可以同時選擇兩種查詢類型。若兩種查詢包含相同成交，Tradeways 會優先採用 Activity 紀錄，並保留其回報的已實現 P&L。所有選取的檔案必須使用相同的報表時區。