pitbridge

PitBridge

NinjaTrader 8 向けのローカルファースト MCP ブリッジです。AI が回避できない厳格なリスク制限を備えています。

PitBridge は、ご自身のマシンで動作するデーモンを介して、AI エージェント（Claude Code、Claude Desktop、または独自のスクリプト）を NinjaTrader 8 の先物口座に接続します。エージェントが要求する注文はすべて、まず決定論的なガードレールエンジンを通過します。ガードレールはデフォルトで有効になっており、プロンプトではなくコードに組み込まれています。また、エージェントにはガードレールを弱めたり、ライブ取引を解除したり、キルスイッチを解除したりするツールはありません。

私たちが作るのはレールであり、アルファではありません。PitBridge が取引対象を指示することはありません。

概要

• ローカルファーストのデーモン（Python 3.12）で、MCP（stdio とストリーミング可能な HTTP）、REST API、WebSocket イベントフィードに対応しています。macOS、Linux、Windows で動作します。
• 決定論的なガードレールエンジン：純粋な同期チェック（日次損失による停止、ポジション上限、取引時間帯、レート制限、キルスイッチなど）を備え、すべての注文はブローカーに届く前に必ずチェックを通過します。
• 薄い NinjaTrader 8 AddOn（C#）がデーモンに接続し、公式の NinjaTrader.Cbi Account API を通じて注文を出します。AddOn は意図的に単純な設計で、安全性に関する処理はすべてデーモン側にあります。
• 追記専用のハッシュチェーン監査ログが、すべてのリクエスト、判断、結果を記録し、注文が許可またはブロックされた理由を正確に確認できます。

概要に含まれないもの

何よりも先に、このセクションをお読みください。

• ブローカーでも取引所でもありません。 PitBridge は、ご自身（またはエージェント）が作成した注文を、既存の NinjaTrader 口座に送ります。資金を保有せず、PitBridge 自体が注文を執行することもありません。
• シグナル、ストラテジー、アルファではありません。 PitBridge に取引ロジックは含まれていません。何を、いつ、どれだけ取引するかを指示することはありません。それはご自身、またはエージェントの役目です。
• 金融・投資アドバイスではありません。 取引インフラです。
• プロップファームの規則に準拠する保証はありません。 ご自身のファームの規則に合う制限を設定してください。PitBridge は、それらをローカルで設定して適用できるよう支援しますが、ファームの規約を守る責任は引き続きご自身にあります。準拠を保証するものではありません。
• クラウド経由の注文リレーではありません。 注文、キー、ポジションが当社のサーバーに送られることはありません。注文経路に PitBridge のアカウントは介在しません。
• 自律的には動作しません。 ライブ執行を有効にするには、コマンドラインでオペレーターのみが行える手順が必要です。エージェントがライブ取引を有効にしたり、キルスイッチを解除したりすることはできません。

アーキテクチャ

注文経路はすべてローカルです。PitBridge 独自のクラウド（マーケティングサイト、ドキュメント、ソフトウェア更新）が注文経路に含まれることはありません。

   AI agent   (Claude Code / Claude Desktop / your own script)
      │
      │   MCP (stdio or HTTP)   REST /v1/*   WS events
      ▼
   PitBridge daemon                         ← runs on YOUR machine
      │
      │   frozen pipeline (no code path skips it):
      │   schema → permission → GUARDRAILS → confirm → submit → audit
      ▼
   Guardrail engine   (deterministic, default-on, not reconfigurable by the agent)
      │
      │   WebSocket on :8873   (the AddOn dials OUT; the NT8 box never listens)
      ▼
   NT8 AddOn   (C#, .NET 4.8, next to NinjaTrader 8 on Windows)
      │
      │   NinjaTrader.Cbi Account API   (close / flatten are strictly reduce-only)
      ▼
   NinjaTrader 8   →   your broker / prop account   (CQG, Rithmic, ...)

   PitBridge's own cloud is NOT on this path.
   Orders, keys, and positions never leave your machine(s).

実行モードは 2 つあります。

• Localhost（デフォルト）：デーモンと NinjaTrader が同じ Windows マシン上で動作し、127.0.0.1 にバインドされます。
• Paired：たとえば Mac 上でデーモンを動かし、NinjaTrader AddOn がご自身のプライベートネットワーク（Tailscale / LAN）を経由して接続します。これが「Mac、Windows マシン、またはその両方で動作する」構成です。ペアリングモードを明示的に有効にし、ペアリングトークンを設定しない限り、ローカルホスト以外へのバインドは拒否されます。

安全モデルの概要

• 決定論的なガードレール。 エンジンは I/O を行わず、LLM も介在しない純粋関数の集合です。check(request, state, now) は Allow、Block（型付きの理由コードを含む）、または RequireConfirm を返します。同じ入力に対しては常に同じ判断を返し、その判断はテスト可能です。
• 固定されたパイプライン。 すべての注文は、スキーマ検証、権限（読み取り専用／ペーパー／ライブ）、ガードレールチェーン、人による確認ゲート（任意）、送信、監査ログへの追記という、同一の経路を必ず通ります。エージェントのインターフェースからブローカーへ、これらを迂回する経路はありません。CI の構造テストにより、そのような経路を追加しようとするとビルドが失敗します。
• エージェントは安全設定を変更できません。 制限はディスク上の設定ファイルに保存され、チェックサムで検証されます。MCP ツールから設定の編集、制限の引き上げ、キルスイッチの解除、ライブ取引の有効化はできません。これらの操作はオペレーターのコマンドラインからのみ行えます。
• ローカルファースト。 デーモンはお使いのコンピューター上で実行されます。注文、キー、ポジションが PitBridge サーバーに送られることはありません。
• キルスイッチ。 ファイル、CLI、または REST 呼び出しから即座に有効化できます。解除できるのは CLI（キーボードを操作する人間）だけです。キルスイッチが有効な間も、リスクを下げる操作（キャンセル、決済、ポジション解消）は意図的に許可されているため、いつでもポジションを解消できます。
• 改ざん検知可能な監査ログ。 ファイル外のアンカーを用いた、追記専用のハッシュチェーン付き JSONL です。pitbridge audit why <id> で任意の注文の理由を確認でき、pitbridge audit verify でチェーンの整合性を証明し、編集、切り詰め、末尾の消去を検出できます。

ガードレール

v0 のガードレールは 12 個あり、それぞれ独立したモジュールとして実装され、すべてテーブル駆動テスト済みです。チェーンは順序が固定されており、最初にキルスイッチ、最後に人による確認ゲートをチェックします。

1. キルスイッチ：ファイル、CLI、または REST から有効化できます。解除は CLI のみで行え、エージェントツールからは解除できません。
2. 日次損失による停止：アカウントごとにニューヨーク時間の日付変更に対応した日次台帳を管理します。上限を超えると、その日の残りの間、停止状態をラッチできます。
3. 利益ロック：設定された利益に達した後は、その日の取引を停止します。
4. 注文ごとの最大契約数：上限を超える単一注文を拒否します。
5. 銘柄およびアカウントごとの最大ポジション：ネットエクスポージャーに上限を設け、上限超過のポジションが、反対方向にも同じく上限超過となるよう反転する注文を拒否します。
6. 銘柄許可リスト：設定された契約のみ取引できます。
7. 取引時間帯と休場日カレンダー：アカウントごとのタイムゾーンに対応し、休場日と短縮取引時間も考慮します。
8. クールダウン：損失後、および／または注文後に、最低限の間隔を設けます。
9. 注文頻度制限：1 分、1 時間、1 日あたりの上限を設けます。
10. 重複注文の防止：同じアカウント、銘柄、売買方向、数量の注文が N 秒以内にある場合、拒否します。
11. リンク切断時のブロック：AddOn へのハートビートが古くなった場合、切断されたリンクへの注文キューイングを避けるため、新規注文を即座に拒否します。
12. 人による確認ゲート：注文を PENDING_CONFIRM として保留し、通知を送り、pitbridge confirm <id>（または REST による承認）を待ちます。60 秒後に自動的に拒否します。

オープンコアの境界

PitBridge はオープンコアです。安全カーネルは、誰でも読んで信頼できるようオープンソースで提供されています。ライブ取引の実行機能と、多数のアカウントを運用するためのオペレーション一式は有料プランに含まれます。

オープンソース（無料）	Pro（有料）
デーモンと完全なガードレールエンジン	ライブ実行の有効化（非公開の LiveExecutionProvider プラグイン）
MCP、REST、WebSocket によるエージェント向けインターフェース	高度なガードレール一式とプロップファーム向けルールパック
読み取り専用ツールとペーパー取引（偽の AddOn／シミュレーションを使用）	複数アカウントへの一括実行（1 回のツール呼び出しで N 個のアカウント）
CLI とハッシュチェーン付き監査ログ	人による確認 UI と監査ログのエクスポート

これはライセンスによる制限であり、DRM ではありません。コアだけで読み取り専用およびペーパー取引のすべての機能を利用できます。ライブ取引には、Pro プラグインに加えて、オペレーターのみが実行できる意図的な arm-live 手順が必要です。

クイックスタート

本日から Mac 上で 完全な デーモンを実行できます。NinjaTrader のインストールも、Windows マシンも、市場データも必要ありません。実際の C# AddOn の代わりに フェイク AddOn シミュレーターを使用するため、ガードレールが適切な注文を通し、不適切な注文を型付きの理由とともにブロックし、キルスイッチですべてを停止し、監査ログからあらゆる判断を説明する様子を確認できます。

cd daemon
uv sync --extra dev
uv run pitbridge run --config ./config.toml     # terminal A
uv run python ../tools/fake_addon.py \           # terminal B
  --host 127.0.0.1 --port 8873 --token pb_pair_demo --account Sim101

その後、REST 経由でペーパー注文を発注するか、Claude を MCP クライアントとして接続し、自然な言葉で指示できます。詳しい手順、すぐに貼り付けて使える設定、Claude Desktop／Claude Code の MCP セットアップブロック、5 つのテストシナリオ、「壊せるか試す」セクションは docs/testing-on-mac.md にあります。

クイックスタートの内容はすべてペーパー／シミュレーションです。実証できることと、できないことの正直な境界については、ガイドの「これで実証できることとできないこと」をご覧ください。

ステータスとロードマップ

PitBridge は開発初期段階にあり、ローンチ前です。現在あるものと、予定しているものを正直にお伝えします。

現在構築・テスト済みのもの（ペーパー／シミュレーションのみ）：

• デーモンのコア、完全なガードレールエンジン（12 個すべてのガードレール）、日次台帳、ハッシュチェーン監査ログ；
• MCP サーバー（9 個のツール）、REST API、WebSocket イベントフィード、CLI；
• エンドツーエンドテストとカオステスト用のスクリプト化されたフェイク AddOn；
• macOS、Linux、Windows の CI で実行される、テーブル駆動型のテストスイート（300 件以上のテスト）。プロンプトインジェクションテストとバイパス防止テストも含まれます。

進行中：

• 実際の C# NinjaTrader 8 AddOn（Sim101 アカウントへの注文ルーティング）。クローズとポジション解消は、厳密なリデュースオンリーとして実装済みです。

予定：

• シャドーモードでの検証。PitBridge を独自のライブプロップトレーディング運用と並行して実行し、ライブ注文をルーティングする前に、注文意図が一致することを実証します；
• オペレーターの承認が必要な、監督下でのライブ移行；
• オープンコアとしての一般公開、ウェブサイト、完全なドキュメント；
• 薄型アダプターによる追加プラットフォーム（Tradovate、ProjectX／TopstepX）への対応。

これまで、PitBridge を介してライブアカウントで取引したことはありません。 ライブ注文のルーティングにはオペレーターのみが実行できる手順が必要であり、現在のビルドには含まれていません。

ドキュメント

• docs/architecture.md：正式なアーキテクチャおよび安全性仕様。
• docs/testing-on-mac.md：フェイク AddOn を使って Mac 上でデーモンを実行・テストする方法。
• SECURITY.md：脆弱性の報告方法。
• CONTRIBUTING.md：貢献方法と、安全性が重要な変更に関するルール。

免責事項

商標について。 NinjaTrader は NinjaTrader Group, LLC の登録商標です。CQG、Rithmic、およびプロップファームの名称は、それぞれの所有者の商標です。PitBridge は独立したプロジェクトであり、NinjaTrader Group, LLC、データ提供者もしくは清算機関、またはいかなるプロップファームとも提携、推奨、または後援関係にありません。プラットフォーム名は、互換性を説明する目的に限り、名称を指すために使用しています。

投資助言ではありません。 PitBridge は取引インフラであり、金融、投資、または取引に関する助言ではありません。シグナル、戦略、推奨は提供しません。

リスクについて。 先物取引には多額の損失が生じるリスクがあり、すべての投資家に適しているわけではありません。ご自身の取引判断、および利用するブローカーやプロップファームの規約の遵守については、すべてご自身の責任となります。

CFTC 規則 4.41（仮想およびシミュレーションによる運用実績）。 PitBridge について示される結果、例、またはシミュレーションデータは、仮想またはシミュレーションに基づくものです。シミュレーションによる運用実績には本質的な制約があります。実際の記録とは異なり、シミュレーション結果は実際の取引を示すものではありません。また、取引が実際に執行されていないため、流動性の不足などの要因を過小または過大に反映している可能性があります。示されたものと同様の利益または損失を、いずれかのアカウントが達成する、または達成する可能性が高いという表明は行っていません。