概念
代碼別名
Tradeways 代碼別名的參考說明 — 在匯入與即時同步時,Broker 專屬的代碼名稱如何對應到標準代碼。
代碼別名會把 Broker 專屬的代碼名稱對應到 Tradeways 內部使用的標準代碼。不同 Broker 經常對同一個標的採用不同的命名方式;舉例來說,某個 Broker 可能傳送 ESZ5,另一個則傳送 ES.FUT。代碼別名可確保兩者都解析為標準代碼 ES。


別名會在匯入與 API 擷取資料時自動建立。它們的範圍會依使用者、依 Broker、依 Broker 帳戶各自區隔。
別名如何建立
當 Tradeways 處理一筆傳入的成交時,會執行一連串解析步驟來判斷標準代碼:
| 步驟 | 來源 | 說明 |
|---|---|---|
| 1 | 提示代碼 | 如果 Broker 在原始代碼之外也提供了正規化後的代碼,會優先檢查這個。 |
| 2 | 既有別名 | Tradeways 會檢查這個代碼是否曾經從這個 Broker 與帳戶出現過。 |
| 3 | 正規化候選 | 原始代碼會先被清理(移除 Broker 前綴、後綴、期貨月份代碼),接著將每個候選與你的標的及內建預設值進行比對。 |
| 4 | 自動建立標的 | 對於透過 API 連線的 Broker,若清理後的代碼符合已知的 Forex 或加密貨幣交易對,系統會自動建立一筆標的紀錄。 |
當一個原始代碼成功解析後,系統會儲存一筆別名紀錄,往後再匯入同一個原始代碼時就會完全略過整個解析流程。
別名紀錄的結構
每筆別名都會儲存原始的 Broker 代碼,以及它所對應的 Tradeways 代碼。別名的範圍依 Broker 與帳戶區隔,因此同一個 Broker 代碼在不同帳戶可以對應到不同的結果。
代碼正規化
Tradeways 在尋找比對結果時,會自動移除常見的 Broker 前綴、後綴與期貨合約代碼。舉例來說,ESZ25 與 ES@CME 都會解析為 ES。
手動別名與自動別名
別名會在檔案匯入或 API 擷取過程中第一次看到某個原始代碼時自動建立。當 Broker 傳送無法自動解析的代碼時,你也可以在設定介面中手動建立、編輯或刪除別名。針對某個原始代碼的手動別名,永遠優先於自動解析。
別名的使用場景
CSV 與 API 匯入都會經過別名流程來解析代碼。第一次成功解析後,別名就會被保存下來,因此往後匯入相同格式時都能立即解析。每筆成交紀錄都會在標準代碼之外保留原始的 Broker 代碼,讓你隨時都能追溯回 Broker 的命名方式。