本文へスキップ

シグナル時と約定時の証拠金チェック:TradingViewパリティの話

読了 約11分

当方ブローカーは次バー始値でフィル時に証拠金ゲートを実行していたが、TradingViewは現在バー終値でシグナル時に実行する。両者の価格差はわずか3セントだったが、エクイティ全額でサイズを決めた注文を棄却させるにはそれで十分だった。6本の隔離プローブで、あるコミュニティ戦略のPnLのずれをその証拠金チェックまでたどった記録。

この記事の数値は2026年5月9日に計測したもので、当時のまま掲載しています。最新の結果はパリティの測定方法をご覧ください。

パリティ・コーパスに含まれるコミュニティ製の Pine ストラテジー IES は、全ストラテジーを strict の閾値で評価するようになってから、TradingView 対比で moderate のパリティにとどまる唯一のストラテジーだった。件数は一致していた。エントリー価格はセント単位で一致し、イグジット価格もセント単位で一致していた。それなのに累積 PnL は、2026年4月までに約 $29,000 もずれていた。

本稿は、その原因を突き止めるまでの記録だ。原因は、1 バー遅れて走っていた、たった一つのマージンチェックだった。

非対称な指紋

掘り下げ始める前、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

この行だけで診断がつく。件数、エントリー価格、イグジット価格がすべて一致しているのに、トレードごとの PnL が 2.5% ずれているなら、それはシグナルロジックのバグでも約定価格のバグでもない。両エンジンは同じトレードを同じ価格で選んでいる。違うのはサイズの決め方だ。

比較ウィンドウの終盤では、マッチしたどのトレードでもエンジンの qty が TradingView の約 97.3% で、両口座のエクイティの比率と同じだった。食い違いがあったのは、あらゆるポジションサイズの式が依存する再帰的なフィードバック変数 strategy.equity であり、トレードごとの計算のどこかではなかった。

最初に試したこと(そして、どれもうまくいかなかった理由)

正しい仮説にたどり着くまでに、間違った仮説を三つ潰した。振り返っておく価値があるのは、それがデバッグの現実の姿だからだ。作業の大半は仮説を裏付けることではなく、潰すことにある。

インジケーターのウォームアップの差。 エンジンは比較ウィンドウが始まる前に、5 か月分の OHLCV で TA スタックをウォームアップする。TradingView のチャート履歴はそこまで遡れないかもしれない。バー単位で TA をトレースするハーネスを作り、その過程で本物のインジケーターのバグを 9 つ見つけた。ta.pivothigh / ta.pivotlow の意味論、ta.iii の式、ta.tsi のコード生成とスケーリング、ta.cog の重み付け、ta.bbw のパーセンテージ、ta.vwap の日次アンカー、ta.supertrend のライン値、ta.pivot_point_levels の前バー HLC、そして ta.cross の同値スキップの意味論だ。9 つすべてを修正した。それでも IES は moderate から抜け出せなかった。

ストップ / リミットの約定タイミング。 別のコミュニティストラテジー(scalping-wunder-bots)には、エンジンが TradingView より 1 バー早くイグジットするという、はっきりしたパターンがあった。エンジンはエントリーバーで strategy.exit のストップを評価しているのに対し、TV は次のバーまで遅らせているのではないか、と仮説を立てた。まさにそれだけを切り出すために parity-probe-01-stop-limit-timing を作った。結果は778 件中 778 件が一致し、4 つの strict ゲートもすべてクリア。仮説は否定された。

CHoCH / BOS のスイング追跡。 別のストラテジー(VCP)には、2025-05-12 12:15 に余計なエントリーが 1 つあり、ピボット状態の変化の仕方が食い違っているのが原因ではないかと疑った。そのピボットのシグネチャを正確に写した 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 で小数第 3 位まで丸めると、TradingView の「List of Trades」CSV にエクスポートされる Size (qty) 列が、TV の strategy.equity の値をバーごとに映し出すオラクルになる。エンジンと TV のトレードをエントリー時刻で突き合わせ、qty 列を並べれば、エクイティの食い違いを差分から直接読み取れる。

マッチした最初の 8 件のトレードは次のとおりだ。

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 は完全に一致した。双方ともエクイティ $1M からのスタートだ。トレード 2 以降、qty 列は離れ、二度と収束しなかった。差はトレード 8 までに約 7.76% で落ち着いた。

原因は計算のドリフトではなかった。トレードの取り逃しだった。本来トレード 2 になるはずだった 2025-04-07 のエントリーは、TV のトレード一覧には載っていたが、エンジンのほうにはなかった。TV はこのトレードを取って $1,345 の損失を被り、エクイティは約 $984k に下がった。エンジンはこのトレードを取らなかったので、エクイティは約 $985k のままだった。続く 2 件のトレードでは、エンジンのサイズが TV より 0.137% 大きかった。その後は採択する月曜日と棄却する月曜日が双方で食い違うようになり、累積損失は異なるエクイティの経路の上で乖離していき、差が縮まることは二度となかった。

幽霊の約定

strategy_entry、process_pending_orders、enter_market_from_flat、apply_market_order_fill に std::cerr のログ出力を追加した。どれも環境変数でゲートし、ほかのテスト実行にノイズが漏れないようにした。

シグナルバー(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 は呼ばれた。注文はキューに入った。ここまでは問題ない。

約定バー(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 した。エラーも、公開ログの行も出なかった。ストラテジーから見れば、そのトレードは単に存在しなかったのだ。(このデバッグ実行はウォームアップ用データの先頭からトレードしていたため、エクイティと qty は後述の比較実行とわずかに異なる。)

TradingView が同じトレードを採択した理由

該当する 2 本のバーの 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。シグナル終値で計算した必要マージンは、利用可能なエクイティをわずか 4 セント上回るだけだ。次のバーの始値で計算した必要マージンは、それを $18.91 上回る。

使用した価格必要マージンエクイティ超過額
シグナル終値($1566.66)$985,319.47$985,319.43+$0.04
約定バーの始値($1566.69)$985,338.34$985,319.43+$18.91

ETH の 3 セントの値動きに 628.93 枚を掛けると、必要マージンは $18.87 増え、超過額は合計 $18.91 になる。エンジンのマージンチェックは約定時に約定価格を使って行われ、棄却した。一方、TradingView のブローカーエミュレータは同じチェックをシグナル時にシグナル終値を使って行い、採択したのだろう。この時点で、我々はそう考えるようになっていた。$985k のポジションにとって 4 セントは、TV が境界に適用している浮動小数点の許容誤差がどれほどであれ、それを下回るはずだからだ。

さらに三つのプローブで絞り込む

これが一トレードだけの偶然ではないこと、そしてバグがまさに 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× マージン境界に張り付いていなければ、どのプローブでも 57 件すべてのトレードでエンジンと TV は完全に一致した。バグが表れるのは境界の上だけで、そこではシグナル終値と約定バーの始値のあいだのスリッページが、マージンチェックの結果をひっくり返しうる。

修正

マージンチェックを、enter_market_from_flat(約定時に約定価格を使って走る)から strategy_entry(シグナル時に現在のバーの終値を使って走る)へ移す。

 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 に十数行を追加し(実際のコミットにはもっと長いコメントが付いている)、あとは enter_market_from_flat から対応する 8 行を削除しただけだ。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

PnL のドリフトは 2.54% から 0.78% に下がった。IES は moderate から excellent に上がった。当時のコーパスのほかの部分では、168 本中 165 本が excellent、2 本が strong、moderate は 0 本で、probe-03 は weak だった(後述)。16 本の ctest バイナリはすべて合格し、codegen の pytest 313 件もすべて合格した。ほかの 161 本のストラテジーにも、回帰は一つもなかった。

どんでん返し

修正後も、parity-probe-03-equity-mirror 自体は TV と完全には一致しなかった。エンジンは 25 回エントリーし、TV は 24 回で、重なったのは 13 回だけだった。probe-03 はまさに 1× エクイティ境界の上に位置するよう設計されているので、二つの実装のあいだで許容誤差の扱いが食い違えば、ほかのどこよりも先にここに表れる。

比較ウィンドウ内の 57 回の月曜日それぞれについて qty * signal_close - equity を計算し、TV が採択したか棄却したかを記録した。そのうち 8 回分を以下に示す。

月曜日シグナル終値での超過額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(equity 未満なのに棄却)
2025-05-26-$0.89REJECT(equity 未満なのに棄却)
2025-08-18+$0.24REJECT
2025-11-10+$0.24TAKE(超過額は同じなのに結果は逆)

8 月 18 日と 11 月 10 日は超過額がどちらも +$0.24 なのに、結果は正反対だ。閾値や許容誤差をどう設定しようと、純粋なマージンチェックのルールでこのパターンは生まれない。この境界での TV のブローカーエミュレータは、ドキュメント化されたどの Pine 変数からも見えない何かに依存している。チャートの読み込み履歴か、ユーザーが公開したときにバーがストラテジーに見えるようになった順序か、あるいは我々には観測しようのない内部状態か。

率直に読めば、これは TradingView のブローカーエミュレータにある、ドキュメント化されていない隅だ。サイジングが 1× エクイティ境界にぴったり固定されたときにだけ表に出る。実際のストラテジーが境界のちょうど上に乗ることは、めったにない。最も近いのは community/IES で、各トレードのサイズを小さなリスク予算とストップまでの距離から決めるため、注文によっては口座のエクイティをほぼ使い切る。それでも修正後には excellent に達した。この隅が実際の利用で大きく響くことはないと考えている。我々は修正を残し、probe-03 を既知の制限として文書化することにした。診断用プローブのティアが見かけ上下がるのは、IES の改善に見合う妥当な代償だ。

このデバッグから学んだ六つのこと

1. 非対称な指標の指紋は、バグの種類を教えてくれる。 件数、エントリー価格、イグジット価格がすべて一致しているのに PnL だけがずれるなら、それはサイジングのバグだ。インジケーターの式を監査する前に、サイジング関連のコードを見るべきだった。

2. 分離プローブは、大きなストラテジーをトレースするよりスケールする。 それぞれ一つの仮説だけを検証する小さな Pine プローブ 6 本が、バグを見つけ出した。エクイティのフィードバック計算を含む 700 行のコミュニティスクリプトで、内部変数をすべてトレースしていたら、もっと時間がかかり、ノイズも増えていただろう。統合レベルだけでデバッグせずにユニットテストを書くのと、同じ理由だ。

3. TradingView の qty= パラメータには、シグナル時のマージンの意味論がある。 チェックに使われるのは strategy.entry が呼ばれたバーで、約定バーではない。これは Pine のリファレンスには書かれていない。Pine 互換のブローカーエミュレータを実装するなら、この挙動に合わせるべきだ。素直に実装すると、チェックは(約定価格が分かっている)約定時に置かれ、黙って壊れる。

4. 境界での浮動小数点は、常に敵だ。 probe-03 の二つのエクイティ経路を分岐させた、たった一つのトレードは、$985k のポジションに対する 4 セントの超過だった。本番のストラテジーは 1〜5% のマージンバッファ(サイジング式に * 0.99 や * 0.95 を入れる)を残し、そもそも境界の上に乗らないようにすべきだ。

5. 複利は、一つのトレードの取り逃しを増幅する。 probe-03 では、04-07 の取り逃しはそれ単体では $1,345 だったが、トレード 8 までに双方のサイズは 7.76% 離れ、その差のまま推移した。取り逃したトレード一つひとつがエクイティの経路をずらし、それが次のサイジングを変え、それがさらに次の採択・棄却の判断を変えるからだ。IES では、同じルールが 13 か月分のトレードにわたって積み重なり、約 $29,000 の差になった。エクイティをフィードバックするストラテジーは、単発の執行のずれに容赦がない。

6. バグが相手側にあることもある。そのときは正直に文書化する。 1× 境界での TV の挙動は、こちら側からは直せない本物の隅だ。一致させようのない指標を黙って追いかけるより、率直に文書化するほうがいい。

この方法論は、今回のバグに限らず一般化できる。パリティ・プローブは、PyneCore とのクロス検証スイープを補完するものだ。PyneCore は、我々のエンジンがほかのエンジンと食い違っていることを教えてくれる。パリティ・プローブは、TradingView と食い違う理由を教えてくれる。新しいギャップを見つけたときの手順は、いまではこうなっている。それを再現する最小の Pine スクリプトを書き、トレード一覧の差分を取り、エンジンに計測用のコードを仕込み、食い違いを直し、折り合いのつかない TV の隅は文書化する。

次の一歩