跳至主要內容

訊號時 vs 成交時的保證金檢查:一則 TradingView 對齊故事

約 11 分鐘閱讀

我們的券商模擬器在成交時,用下一根 K 棒的開盤價檢查保證金;TradingView 則是在訊號時,用當根收盤價檢查。兩個價格只差 3 美分,就足以讓一筆用滿全部權益的訂單被拒絕。六支隔離探針如何把一支社群策略的損益漂移,一路追查到這道保證金檢查。

本文數據量測於 2026年5月9日,並保留當時的原貌。最新結果請參閱我們如何衡量一致性。

我們對齊語料庫裡有一支叫 IES 的社群 Pine 策略。我們用嚴格門檻替每一支策略評定等級之後,它是唯一一支對 TradingView 的對齊等級落在 moderate 的策略。交易筆數對得上,進場價對到分,出場價也對到分。但到了 2026 年 4 月,兩邊的累積損益已經相差約 29,000 美元。

這篇文章記錄我們如何找到原因:一個晚了一根 K 線才執行的保證金檢查。

不對稱的指紋

在我們開始深挖之前,verify_corpus.py 對這支策略的報告如下:

community/IES (pre-fix)
  Profile:       strict
  TV trades:     2668  (raw 2668)
  Engine trades: 2663  (raw 2663)
  Matched:       2632 (98.7% of TV)
  Count delta:             0.1874%  (OK)
  Entry-price p90 delta:   0.0000%  (OK)
  Exit-price  p90 delta:   0.0000%  (OK)
  PnL         p90 delta:   2.5412%  (X)
  -> moderate

光是這一行,就很有診斷價值。當交易筆數、進場價與出場價全部一致,每筆交易的損益卻漂移了 2.5%,你面對的就不是訊號邏輯的 bug,也不是成交價的 bug。兩個引擎在同樣的價格選了同樣的交易,只是部位大小算得不一樣。

接近比對區間尾聲時,引擎在每一筆吻合交易上的 qty,都大約是 TradingView 的 97.3%,和兩個帳戶的權益比例相同。分歧出在 strategy.equity——每一條部位計算公式都依賴的遞迴回饋變數——而不在任何一筆交易的算術上。

我們先試了什麼(以及為什麼都沒用)

在找到正確的假設之前,我們接連押錯了三個。這些值得說一說,因為這才是除錯的真實樣貌:大部分的工作是推翻假設,而不是證實假設。

指標暖機期不一致。 引擎會在比對區間開始前,先用五個月的 OHLCV 替技術分析堆疊暖機;TradingView 圖表的歷史資料未必有那麼長。我們做了一套逐根 K 線追蹤技術指標的工具,過程中還真的找出九個指標 bug——ta.pivothigh / ta.pivotlow 的語意、ta.iii 公式、ta.tsi 的 codegen 與縮放、ta.cog 權重、ta.bbw 百分比、ta.vwap 的每日錨點、ta.supertrend 的線值、ta.pivot_point_levels 的前一根 K 線 HLC,以及 ta.cross 略過平手的語意。九個全都修好了,卻沒有一個能讓 IES 脫離 moderate。

停損/限價的成交時機。 另一支社群策略(scalping-wunder-bots)有個很明確的模式:引擎比 TradingView 早一根 K 線出場。我們假設引擎在進場那根 K 線上就評估了 strategy.exit 的停損,而 TV 則延到下一根。於是我們做了 parity-probe-01-stop-limit-timing,專門隔離這一點。結果是 778 筆交易中有 778 筆吻合,四道嚴格門檻全部通過。假設被推翻了。

CHoCH/BOS 波段追蹤。 還有一支策略(VCP)在 2025-05-12 12:15 多出一筆不該出現的進場,我們懷疑是樞紐點狀態的演變出現分歧所致。我們做了 parity-probe-02-choch-bos-isolator,完全複製它的樞紐點特徵。1026 筆中有 1026 筆吻合。 又被推翻了。

三個假設試下來,IES 毫無起色,倒是多了一條新的方法論:寫出最小的 Pine 策略、一次只隔離一個假設,遠比在一支 700 行的社群腳本裡追內部變數快得多。於是我們寫了第三支探針。

揪出問題的那支探針

parity-probe-03-equity-mirror 的巧妙之處在於,下單數量本身就編碼了 strategy.equity:

//@version=6
strategy("Parity probe 03 - equity mirror",
         shorttitle="par_p03", overlay=true, initial_capital=1000000,
         default_qty_type=strategy.fixed, default_qty_value=1,
         pyramiding=0, process_orders_on_close=false,
         commission_value=0, slippage=0)
 
bool fire = dayofweek == 2 and hour == 0 and minute == 0
            and strategy.position_size == 0
 
float qty_dyn = math.round(strategy.equity / close * 1000) / 1000
 
if fire and qty_dyn > 0
    strategy.entry("E", strategy.long, qty=qty_dyn)
 
if strategy.position_size > 0 and bar_index >
        strategy.opentrades.entry_bar_index(0)
    strategy.close("E")

qty = round(strategy.equity / close * 1000) / 1000 四捨五入到小數點後三位,這代表 TradingView「交易清單」CSV 匯出的 Size (qty) 欄,會逐根 K 線把 TV 端的 strategy.equity 數值透露出來。依進場時間戳記把引擎和 TV 的交易配對、把 qty 欄並排,就能直接從 diff 讀出權益的分歧。

前八筆吻合的交易:

2025-03-31 00:15  eng_qty=553.1490  tv_qty=553.1490  diff=+0.000%
2025-04-14 00:15  eng_qty=612.9970  tv_qty=612.1600  diff=+0.137%
2025-04-21 00:15  eng_qty=623.1630  tv_qty=622.3110  diff=+0.137%
2025-08-25 00:15  eng_qty=207.2020  tv_qty=209.8110  diff=-1.244%
2025-11-03 00:15  eng_qty=242.4760  tv_qty=251.9860  diff=-3.774%
2025-11-24 00:15  eng_qty=339.1820  tv_qty=361.0170  diff=-6.048%
2025-12-22 00:15  eng_qty=307.0180  tv_qty=330.5680  diff=-7.124%
2026-01-05 00:15  eng_qty=295.2650  tv_qty=320.1020  diff=-7.759%

第 1 筆交易完全吻合,兩邊都從 100 萬美元的權益起步。從第 2 筆開始,兩邊的 qty 欄就分道揚鑣,再也沒有收斂回來。到第 8 筆時,差距穩定在 7.76% 左右。

原因不是計算上的漂移,而是漏掉了一筆交易。原本應該是第 2 筆的那次進場(2025-04-07),出現在 TV 的交易清單裡,卻沒有出現在引擎的清單裡。TV 接下了這筆交易,吃下 1,345 美元的虧損,權益降到約 984k 美元。引擎始終沒有進場,所以權益停在約 985k 美元。接下來兩筆交易,引擎的部位都比 TV 大 0.137%;在那之後,兩邊接受和拒絕的週一各不相同,累積虧損沿著不同的權益路徑分岔,差距從此再也沒有消失。

幽靈成交

我們在 strategy_entry、process_pending_orders、enter_market_from_flat 和 apply_market_order_fill 裡加上 std::cerr log,並全部用環境變數控制開關,免得這些雜訊混進其他測試。

在訊號 K 線,2025-04-07 00:00:

[entry CALL] ts=1743984000000 bar=16236 id=E is_long=1 qty=627.312
             pending_orders.size=0 pos_qty=0 pos_side=0

strategy.entry 被呼叫了,訂單也進了佇列。到目前為止都沒問題。

在成交 K 線,2025-04-07 00:15:

[ppo] ts=1743984900000 bar=16237 pass=0 i=0 id=E type=0 is_long=1
      qty=627.312 eligib=FILL_TRY
    -> fill.kind=0 fill_price=1566.69
    -> AFTER apply: pos_qty=0 pos_side=0 pyramid.size=0 trades.size=14

fill.kind=0 就是 FillEvaluation::Kind::Fill。價格評估器說要成交,apply_filled_order_to_state 也被呼叫了,部位狀態卻沒有更新。一筆幽靈成交。

再加一行除錯輸出,這次放在 enter_market_from_flat 裡,印出保證金防線的輸入值:

[margin] ts=1743984900000 qty=627.312 fill_px=1566.69 margin_pct=100
         required=982803 available_equity=982785 net_profit_sum=-17215.4
         initial=1e+06 block=YES

所需保證金:982,803 美元。可用權益:982,785 美元。保證金防線要求的金額比帳戶現有的多出約 19 美元,於是提早 return,沒有更新任何狀態,也沒有產生錯誤或任何公開的 log。從策略的角度來看,這筆交易根本不存在。(這次除錯執行是從暖機資料的一開始就進行交易,所以它的權益和 qty,跟下面那次比對執行略有出入。)

為什麼 TradingView 接下了同一筆交易

相關的兩根 K 線 OHLC 如下:

04-07 00:00 (signal): O=1579.98  H=1585.57  L=1566.00  C=1566.66
04-07 00:15 (fill):   O=1566.69

探針以訊號收盤價計算下單數量:qty = round(985319.43 / 1566.66 * 1000) / 1000 = 628.93。以訊號收盤價計算的所需保證金,只比可用權益多出四美分;以下一根 K 線的開盤價計算,則超出 18.91 美元。

使用的價格所需保證金權益超出金額
訊號收盤價($1566.66)$985,319.47$985,319.43+$0.04
成交開盤價($1566.69)$985,338.34$985,319.43+$18.91

ETH 只動了三美分,乘上 628.93 張合約,就多出 18.87 美元的所需保證金,總共超出 18.91 美元。引擎的保證金檢查發生在成交時,用的是成交價——於是拒絕了。我們這時認為,TradingView 的券商模擬器是在訊號時用訊號收盤價做同樣的檢查——於是放行,因為在 985k 美元的部位上,四美分的差距低於 TV 在邊界上採用的浮點數容差,不論那個容差是多少。

再用三支探針交叉定位

為了證明這不是單筆交易的巧合,而且這個 bug 確實只跟 1 倍權益邊界有關,我們又做了三支探針,從不同距離把這個邊界夾住:

探針部位計算保證金壓力
parity-probe-04-percent-of-equity-sizingdefault_qty_type=percent_of_equity, default_qty_value=99約 99% 權益
parity-probe-05-small-equity-fractionqty = round(equity / close * 100) / 1000約 10% 權益
parity-probe-06-edge-margin-sizingqty = round(equity * 0.5 / close * 1000) / 1000約 50% 權益

我們將三支探針的引擎交易清單,分別與 TradingView 交易清單(Strategy Tester › List of trades)比對:

parity-probe-04: TV=57  engine=57  matched=57/57 (100.0%)  PnL p90=0.0006%  → excellent
parity-probe-05: TV=57  engine=57  matched=57/57 (100.0%)  PnL p90=0.0698%  → excellent
parity-probe-06: TV=57  engine=57  matched=57/57 (100.0%)  PnL p90=0.0700%  → excellent

只要部位大小沒有釘在 1 倍保證金邊界上,引擎和 TV 在每支探針的全部 57 筆交易上都完全一致。這個 bug 只在邊界上現形:訊號收盤價和成交開盤價之間的滑價,足以翻轉保證金檢查的結果。

修正方式

把保證金檢查從 enter_market_from_flat(在成交時執行,使用成交價)移到 strategy_entry(在訊號時執行,使用當根 K 線的收盤價):

 void BacktestEngine::strategy_entry(const std::string& id, bool is_long,
                                     double limit_price, double stop_price,
                                     double qty, ...) {
     if (!trading_is_active(...)) return;
+
+    // TradingView broker rule: market-entry orders are admitted only
+    // when qty * <signal-bar close> * margin_pct/100 <= equity. Check
+    // happens HERE at signal time with current_bar_.close, NOT later
+    // in apply_market_order_fill where fill_price is the next bar's
+    // open. Verified empirically by parity-probe-{03..06}.
+    if (!std::isnan(qty) && std::isnan(limit_price) && std::isnan(stop_price)) {
+        double margin_pct = is_long ? margin_long_ : margin_short_;
+        if (margin_pct > 0.0 && !std::isnan(current_bar_.close)) {
+            double required = std::abs(qty) * current_bar_.close * (margin_pct / 100.0);
+            double available = current_equity();
+            double epsilon = std::max(1e-9, std::abs(available) * 1e-12);
+            if (required > available + epsilon) {
+                return;
+            }
+        }
+    }
     ...

strategy_entry 裡大約十幾行(實際的 commit 附有更長的註解),外加從 enter_market_from_flat 刪掉對應的八行。在 IES 上重跑:

community/IES (post-fix)
  TV trades:     2668  (raw 2668)
  Engine trades: 2643  (raw 2643)
  Matched:       2618 (98.1% of TV)
  Count delta:             0.9370%  (OK)
  Entry-price p90 delta:   0.0000%  (OK)
  Exit-price  p90 delta:   0.0000%  (OK)
  PnL         p90 delta:   0.7809%  (OK)  ← was 2.5412%
  -> excellent

損益漂移從 2.54% 降到 0.78%,IES 從 moderate 升到 excellent。當時語料庫的其餘部分:168 支策略中有 165 支是 excellent、2 支是 strong、0 支是 moderate,probe-03 則是 weak(見下文);16 個 ctest 執行檔全部通過,313 個 codegen pytest 測試案例也全部通過,其他 161 支策略都沒有出現任何迴歸。

劇情反轉

修正之後,parity-probe-03-equity-mirror 本身和 TV 仍然沒有完全吻合。引擎進場 25 次,TV 進場 24 次,其中只有 13 次重疊。Probe-03 的設計本來就是剛好貼在 1 倍權益邊界上,所以兩套實作在容差上的任何分歧,都會最先在這裡浮現。

比對區間內共有 57 個週一,我們針對每一個週一計算 qty * signal_close - equity,並記下 TV 接受或拒絕的決定。以下是其中八個:

週一以訊號收盤價計算的超出金額TV 的動作
2025-04-07+$0.04TAKE
2025-04-14-$0.76TAKE
2025-04-21-$0.19TAKE
2025-04-28+$0.34REJECT
2025-05-12-$0.18REJECT(低於權益,卻被拒絕)
2025-05-26-$0.89REJECT(低於權益,卻被拒絕)
2025-08-18+$0.24REJECT
2025-11-10+$0.24TAKE(超出金額相同,結果相反)

8 月 18 日和 11 月 10 日的超出金額同樣是 +$0.24,結果卻完全相反。任何單純的保證金檢查規則——不論門檻或容差怎麼設——都不可能產生這種模式。TV 的券商模擬器在這個邊界上,取決於某種在任何有文件記載的 Pine 變數裡都看不到的東西:可能是圖表載入的歷史、使用者發布時 K 線對策略變得可見的順序,或某種我們無從觀察的內部隱藏狀態。

坦白說,我們的解讀是:這是 TradingView 券商模擬器裡一個沒有文件記載的邊角情況,只有在部位大小精準釘在 1 倍權益邊界上時才會出現。實際的策略很少剛好落在這條邊界上。最接近的是 community/IES:它依照一筆不大的風險預算和停損距離來計算每筆交易的部位,所以有些訂單幾乎用掉了帳戶的全部權益,而修正之後它仍然達到 excellent。我們預期這個邊角情況在實際使用上影響不大。我們選擇保留這次修正,並把 probe-03 記錄為已知限制。診斷用探針的等級在帳面上被調降,換來 IES 的改善,這個代價很公道。

這次除錯教會我們的六件事

1. 不對稱的數據指紋,能指出 bug 屬於哪一類。 當交易筆數、進場價和出場價全都一致,損益卻在漂移,你面對的就是部位計算的 bug。我們早該先去看部位計算相關的程式碼,再來審查指標公式。

2. 隔離探針比追蹤大型策略更好擴展。 六支小型 Pine 探針,每支只測一個假設,就找到了 bug。要是在一支帶有權益回饋計算的 700 行社群腳本裡追蹤每一個內部變數,花的時間會更長,雜訊也更多。這和我們寫單元測試、而不是只在整合層除錯,是同樣的道理。

3. TradingView 的 qty= 參數採用訊號時的保證金語意。 檢查用的是呼叫 strategy.entry 的那根 K 線,而不是成交的那根。Pine 的參考文件沒有寫到這一點。任何要實作 Pine 相容券商模擬器的人都應該比照辦理;直覺的實作會把檢查放在成交時(這時成交價已知),然後悄無聲息地出錯。

4. 邊界上的浮點數永遠是敵人。 讓 probe-03 兩條權益路徑分岔的那一筆交易,只不過是在 985k 美元的部位上超出了四美分。正式上線的策略應該保留 1% 到 5% 的保證金緩衝(在部位計算公式裡加上 * 0.99 或 * 0.95),根本不要貼著邊界走。

5. 複利會放大單筆交易的遺漏。 在 probe-03 裡,光是 04-07 那一筆漏掉的交易,就是 1,345 美元;到了第 8 筆交易,兩邊的部位大小已經相差 7.76%,之後也一直維持在這個差距,因為每一筆漏掉的交易都會改變權益路徑,進而改變下一次的部位計算,再進而改變下一次接受或拒絕的決定。在 IES 上,同樣的規則套在 13 個月的交易上,累積出約 29,000 美元的差距。帶有權益回饋的策略,對零星的執行缺口毫不寬容。

6. 有時候 bug 在對面,那就老實記錄下來。 TV 在 1 倍邊界上的行為,是一個我們無法從自己這一側修正的真實邊角情況。坦白記錄下來,勝過默默追逐一個根本對不上的指標。

這套方法論不只適用於這個 bug。對齊探針和我們的 PyneCore 交叉驗證掃描互補:PyneCore 告訴我們,我們的引擎什麼時候和另一個引擎不一樣;對齊探針則告訴我們,它為什麼和 TradingView 不一樣。現在每發現一個新缺口,我們的標準流程就是:寫出能重現它的最小 Pine 腳本、diff 交易清單、替引擎加上觀測輸出、修正分歧,再把無法調和的 TV 邊角情況記錄下來。

接下來可以做什麼

  • 從 Claude 或 Cursor 轉譯並回測:本機 MCP 伺服器的 transpile_pine 工具,會回傳 PineForge 從你的 Pine 原始碼產生的 C++;保證金檢查本身是在引擎的 runtime 裡執行,不在那段產生出來的程式碼裡。
  • 瀏覽畫廊:開放語料庫目前的 312 支策略,每一支都和 TradingView 逐筆交易比對過。
  • 我們如何衡量對齊:目前的結果與資料來源。