選一條訊號出口,先完成模擬驗證
QuantBrains 算出的是目標部位,外部下單工具再依自己的設定執行。這一頁說明何時需要附加套件、開始前要準備什麼,以及如何確認訊號確實送到正確商品與帳戶。
01 我需要附加套件嗎?
這個按鈕不是套件商店,也不是 DLL 安裝入口。要使用提供者交付的外掛,請從資金管理專案的「訊號輸出設定」選取;一般套件檔案不填在授權視窗。
| 您的情境 | 使用方式 | 先閱讀 |
|---|---|---|
| 現有下單工具可以讀文字檔 | 使用內建檔案輸出,按對方要求設定格式與路徑。 | 訊號輸出設定 |
| 使用下單大師 | 使用平台既有的下單大師設定與商品映射。 | 自動建商品與下單大師 |
| 整合商提供相容 DLL | 在「訊號輸出設定」選取該 DLL。 | 下一節的啟用流程 |
| 使用 TradersPost | 本專案有範例外掛;取得可用套件後設定連線與商品。 | TradersPost 設定練習 |
| 需要將部位讀回 MultiCharts/STO | 先取得並確認對應的外部公式套件,再按其版本說明操作。 | 回送 MC/STO |
使用 Data Center 的 AI 資料連接,不需要上述交易外掛;請看資料中心 AI 安裝。
多個工具若同時控制同一商品與帳戶,可能重複執行。開始前列出「QuantBrains 專案 → 出口 → 接收工具 → 模擬帳戶」,確認每一段的用途。
向套件提供者確認的五件事
- 套件名稱、版本、適用的 QuantBrains/MultiCharts 版本,以及是否支援目前 64 位元環境。
- 需要哪些檔案,應放在哪裡,哪些設定由您填寫。
- 接收「目標總部位」還是「本次增減量」;正數、負數與 0 的意思。
- 外部商品代碼、合約月份、帳戶、口數單位和允許交易的商品。
- 斷線、重啟、訊號重複、反手及人工改倉後,如何核對和恢復。
02 使用已提供的相容 DLL 外掛
DLL 是由整合商提供的外掛檔案。您不需要自行寫程式,但必須取得完整可執行套件及其設定說明;只有來源程式或只有單一 DLL,可能不足以使用。
- 先取得套件。把 DLL、設定檔及必要配套放到固定位置,例如您自己的外掛資料夾。不要放在暫時下載位置後又移走。
- 完成外掛本身設定。依提供者說明填入連線、模擬帳戶、商品映射及其他必要參數。
- 停止監控再修改輸出。在目標資金管理專案開啟「訊號輸出設定」。
- 勾選「啟用自訂 DLL 輸出」。按「選擇 DLL」,選正確檔案,確認顯示的完整路徑。
- 按「套用設定並關閉」。重新打開設定確認勾選與路徑;若顯示驗證錯誤,先修正再套用。
- 在測試環境觀察。確認平台目標部位、外掛紀錄及接收端訊號一致,再依下面檢查表練習。
平台與外掛的成功紀錄只代表對應傳送階段。委託是否接受、成交以及帳戶實際持倉,要到下單工具與券商端核對。
更新或停用外掛
修改 DLL 或外掛設定前,先停止監控、停用該出口並保存設定。完整更新後重新啟動 QuantBrains,使新 DLL 與設定生效,再做模擬核對。停用出口不會自動平掉已存在的持倉,也不能用來撤回外部工具已接受的訊號。
03 情境:使用 TradersPost 範例套件
專案提供 TradersPostSignalPlugin 範例。一般使用者先取得建置完成、與目前 QuantBrains 相容的套件,確認其中有 TradersPostSignalPlugin.dll 和同資料夾的 TradersPostSignalPlugin.config;本頁不需要您編譯程式。
| 設定項目 | 填寫與檢查方式 |
|---|---|
| WebhookUrl | 貼入您在 TradersPost 建立的完整 Webhook 網址。此範例只接受 HTTPS 且主機為 webhooks.traderspost.io 的網址;不能保留範本佔位文字。 |
| Test | 範例預設 true,第一次先保留測試設定,並使用測試或模擬接收環境。到接收端確認實際測試狀態;不要只依本機開關推定外部帳戶。 |
| SendOnlyOnPositionChange | 一般保留 true,只在目標部位改變時送出。 |
| Symbol.商品代碼 | 把 QuantBrains 商品代碼對應到 TradersPost 接受的商品及合約。未設定時會沿用 QuantBrains 代碼,可能不是您要交易的合約。 |
| 紀錄與狀態檔 | 保留套件的預設檔案,並確認資料夾可讀寫;不要為了重送而自行刪除。 |
期貨需核對明確合約及月份,不能只看連續商品代號。TradersPost 對商品、訊號與合約的目前說明可參考 官方訊號說明。
從設定到確認接收
- 在 TradersPost 準備測試用策略/連接,確認允許的商品與帳戶。若希望採用外掛傳入數量,依該端說明確認允許訊號數量覆寫。
- 編輯套件設定檔,填 WebhookUrl 與每個商品映射,保留測試設定並儲存。
- 依上一節在 QuantBrains 選擇 DLL,套用後重新啟動使外掛設定生效。
- 在測試或模擬環境,從無部位開始觀察一次目標部位改變。查看外掛紀錄是否成功,再到 TradersPost 確認商品、方向與數量。
- 逐項測試加碼、減碼、平倉與反手。若開始時平台與接收端並非相同部位,先核對差異,不直接測下一筆。
平台從 0 變成 +2,代表目標兩口多單;從 +2 變成 +3,增加的是一口。此範例會參考先前成功送出的狀態換算增減,並不直接讀取券商實際持倉。若您在外部人工改倉,先停止這條自動流程,核對平台、外掛與帳戶,再按提供者說明恢復。
先查看 TradersPostSignalPlugin.log。未完成訊號可能保留並於後續重試;請保留狀態與待處理檔案,核對外部是否已接收,再由維護者協助恢復。刪除檔案可能讓外掛忘記之前狀態,重複下單或算錯差額。
04 選用:將目標部位讀回 MultiCharts
舊版教材的 _QB_Order_FromTXT 會讀取 QuantBrains 文字訊號,再由 MultiCharts 自動下單(AA)執行。這組公式、_readNum 與相容 outputfile_64.dll 需向套件提供者確認;目前專案內的 Connect 文字檔不代表已提供完整回送套件。
| 先準備 | 操作重點 |
|---|---|
| 訊號檔 | 從 QuantBrains 設定可寫入的專用輸出位置。舊版套件使用 $PositionQBN 格式;使用前核對手中版本是否相同。 |
| 專用暫存檔 | 舊版套件要求初始內容 0QBN。依套件規格建立,每個商品使用獨立路徑,不和訊號檔共用。 |
| 相容公式與 DLL 路徑 | 請提供者確認套件已指向目前電腦的 DLL。編譯失敗或缺少依賴時,先修好套件再進行。 |
| 專用下單圖表 | 商品、合約、模擬帳戶、週期與策略屬性依套件版本設定,與研究圖表分開。 |
- 先讓 QuantBrains 產生訊號檔,確認目標部位與檔案內容。
- 在套件公式的設定填入訊號檔及暫存檔路徑,確認 MultiCharts 讀到相同目標。
- 在不送單狀態先看讀值;之後使用模擬帳戶依 MultiCharts 流程啟用 AA。
- 核對加碼、減碼、平倉與反手。若同一根 K 棒的多次更新遺漏,按套件說明檢查同向下單與單棒執行次數。
舊教材的 1 秒週期與固定歷史範圍不是所有版本的通用要求;以提供者確認的設定為準。文字檔、讀值與委託可能有延遲,應分段查看實際結果。
05 選用:STO 社群套件
@QB_To_STO 是舊教材提到的社群整合方式,會額外使用 accountall.txt 指定帳戶分派。使用前先取得相容套件與其帳戶檔規格。
- 先完成套件要求的 QuantBrains 訊號檔與 MultiCharts 讀值測試。
- 依提供者格式準備
accountall.txt,在套件中選正確完整路徑。 - 以模擬環境逐帳戶檢查商品、方向、口數與分派;其中一個帳戶成功,不代表全部帳戶都正確。
- 練習 STO 未啟動、帳戶檔無法讀取與 MultiCharts 重啟時的處理,保存自己的恢復順序。
帳戶分派由外部套件處理,不會因 QuantBrains 專案名稱相同就自動完成。帳戶不符時先停用自動執行,核對檔案與映射後再測試。
06 一個商品的模擬檢查表
以下例子描述預期「目標部位」,不是要您直接對實盤手動寫入訊號。用套件提供的測試方式,觀察每個階段是否一致。
| 情境 | 要看到的結果 | 不一致先查 |
|---|---|---|
| 初始無部位 | 平台與接收端都確認無部位。 | 原有持倉、首次訊號與外掛狀態。 |
| 0 → +1 | 正確商品與模擬帳戶的目標為一口多單。 | 商品映射、正負號、帳戶與數量設定。 |
| +2 → +1 | 減少一口,最後剩一口多單。 | 目標總量是否誤當成這次委託量。 |
| +1 → 0 | 目標回到無部位,確認外部委託及實際結果。 | 平倉規則、已有委託及外部拒單原因。 |
| +1 → -1 | 依套件規則處理反手,最後為一口空單。 | 反手順序、延遲及執行中的委託。 |
| 部位不變、斷線與重啟 | 無意外重複動作,恢復前可核對狀態。 | 訊號更新時間、保留的狀態、待處理訊號與接收端紀錄。 |
外部工具完全沒有反應
依序確認監控與輸出啟用、目標部位、套用後的路徑、檔案/外掛紀錄,最後才看接收端。若平台有保存失敗或安全模式提示,先依儲存與監控說明處理,不能靠外部重試代替。
DLL 載入失敗
確認完整路徑、相容版本及配套檔案,並在更新後重啟 QuantBrains。保留平台錯誤文字交給提供者;不需要自行修改程式入口。
外部訊號收到,但帳戶沒有成交
到外部工具查看是否為測試模式、帳戶啟用狀態、商品允許清單、數量限制與拒單訊息,再到券商端核對。不要只因平台顯示成功就認定持倉完成。
如何暫停整條流程
停止 QuantBrains 監控並停用該出口,同時依外部工具流程停用自動執行;再核對已送訊號、掛單與持倉。停止訊號產生與處理既有委託是不同動作,恢復時先對齊兩邊狀態。
能從平台一路指出訊號在哪裡產生、被哪個工具接收、對到哪個帳戶,並能重做基本部位變化與恢復演練。把套件版本、設定和檢查結果保存到交易備忘錄。