QuantCraft ドキュメントリファレンス

QuantCraft には、相互に補完する 2 種類のドキュメントが付属しています。IDE 内で読むアプリ内トピックと、API の詳細のために製品に同梱されているストラテジーリファレンスの Markdown です。これらを合わせて、ストラテジーの書き方、バックテストの実行方法、IDE の使い方を説明しています。この Web ドキュメントは、それらのトピックの多くを反映しています。まずははじめにまたは入門から始めてください。

---

アプリ内でドキュメントを読む場所

1. メインアプリから QuantCraft を開きます。
2. 右サイドバーを展開します（折りたたまれている場合）。
3. Documentation タブ（QuantCraft AI の隣）を開きます。

トピックの検索可能な索引が表示されます。検索ボックスに入力すると、タイトル、要約、埋め込まれたキーワード（たとえば on_finish、PaperAccount、chart_indicator_series）で絞り込めます。

トピックカードをタップすると、記事全文が開きます。Back で索引に戻ります。

---

トピック索引（アプリ内）

トピックは、Documentation サイドバーに対応する 2 つのセクションにまとめられています。

Getting started

Reference

索引のカードのうち、まだ記事全文が開かないものには、UI 上で Soon と表示されます。

---

アプリ内ドキュメントとワークフローの関係

IDE で何かをしているときは、このクイックマップを使ってください。

アプリ内の記事は、ストラテジー作成者と IDE ユーザー向けに書かれています。QuantCloud のサーバー運用者向けのセットアップは、この公開ドキュメントでは扱いません。

---

ストラテジーのインポート

すべてのインポートは quantcraft.* で書いてください。モジュール名はサフィックスなしです（たとえば quantcraft.inputs であり、quantcraft.inputs_module ではありません）。古い ide.* や quantcraft.*_module のパスも、quantcraft.backtest.*（quantcraft.process.* に改名される前のパッケージの旧名）と同様に、引き続き解決されるため、既存のストラテジーは変更なしで動き続けますが、新しいコードはそれらに対して書かないでください。

より短い再エクスポートも使えます：quantcraft.indicator_series、quantcraft.account。Fama-French では、from quantcraft import fama_french を使い、コールバック内で fama_french.qc を読み取ることを推奨します。

Fama-French の行へのアクセス： dataset["rows"] はリストではなく YYYYMM → 値の dict です。.row(...) または .rows_chronological(...) を使い、latest_row(...) はフォワード実行でのみ使ってください（バックテストでは先読みになります — Fama-French ファクターを参照）。rows[0] / rows[-1] は使わないでください。

ストラテジースクリプトでは、quantcraft.b2.*（価格やファンダメンタルデータのローダーの背後にあるデータダウンロード層）や quantcraft.ai_assistant.* のような内部パッケージを使わないでください。これらはストラテジー API ではなく、内部ヘルパーです。quantcraft.process.ohlcv（ストラテジー用 OHLCV API）と quantcraft.b2.ohlcv（内部データ層）を混同しないでください。

クロスセクショナルヘルパー

quantcraft.cross_sectional には、多数のシンボルを一度に比較するためのベクトル化されたヘルパー（numpy）があります：stack_field、latest_return、latest_sma、latest_std、latest_rsi、rank、zscore、demean、winsorize、そして ColumnarBarArena。

書かれているとおり、フォワード／バルク実行専用です。****バックテストでは、rt.qc_ohlcv_by_symbol は各シンボルの読み込み範囲全体を保持するため、そこでの「最新」はテストの最後のバーを意味し、先読みになります。バックテストでは、実行が進む間に各シンボルの bar から終値を収集し、それらの配列をヘルパーに渡してください。

モジュールハンドルとインポート名の違い

quantcraft.process.runtime と quantcraft.fama_french はモジュールのエイリアスなので、属性アクセスはセッションごとの最新の値を読み取ります。

それ以外はすべて名前を値で再エクスポートするため、from ... import <name> はインポート時に取られたスナップショットを束縛します。

エンジンが実行ごとに割り当てるハンドルについては、エンジンがルートのアルゴファイルを読み込んだ後にそれらの名前を再束縛するため、再束縛される名前に限り、そこでは from ... import の形で安全です。

• バックテスト / Debug Test： account、chart_indicators、get_bar、qc_ohlcv、qc_ohlcv_by_symbol、qc_ohlcv_by_tf、qc_fundamentals、qc_fama_french、qc_calendar。
• フォワード実行： account、qc_fundamentals、qc_fama_french のみ — そのため、chart_indicators や OHLCV のハンドルには rt.<name> を使ってください。

分割されたヘルパーモジュールは異なります。同じプロセス内で実行をまたいで sys.modules にキャッシュされ続けるため、インポートした名前は最初のインポート時に現行だったセッションのハンドルを保持し、次の実行（フォワード／バルク）では古くなります。ヘルパーモジュールでは、モジュールをインポートして属性アクセスを使ってください。

from quantcraft.inputs import params は例外です。params は実行ごとに値が変わる 1 つのライブなオブジェクトなので、from の形はどこでも安全です — 入力パラメータを参照してください。

---

同梱のストラテジーリファレンス（Markdown）

モジュールの動作の細部、コールバックの契約、エンジンの詳細については、製品に quantcraft-dev バンドル（概念的には「QuantCraft ストラテジーリファレンス」）として Markdown も含まれています。典型的な目次は次のようになります。

これらのファイルは、正確な名前と契約を必要とするストラテジー作成者向けです。BACKTEST_MODULE（WebSocket バックテストのエントリーポイント）や IDE_BACKTEST_RUNNER（サブプロセスランナー）のような上級トピックは、コントリビューター向けにバンドルに含まれていますが、主要なユーザー経路ではありません。IDE の QuantCraft AI にはこの資料があらかじめ読み込まれており、回答が出荷されているモジュールと整合し続けるようになっています。

---

QuantCraft のその他のヘルプの入口

これらは Documentation タブではありませんが、ユーザー向けの同じ「リファレンスのエコシステム」の一部です。

• QuantCraft AI — 自然言語で質問できます。回答は同じ開発用コーパスを引用できます。AI → API Providers でモデルを接続します（自分のキー、または QuantCraft Premium／ホスト型オプション）。
• インポートとエクスポート — .py（および関連）ファイルをディスクとワークスペースの間で移動します。
• テスト結果 — バックテスト後の資産チャート、指標、取引、HTML エクスポート。

---

検索のヒント

• コード内に現れる短いトークンを優先してください：on_finish、params、chart_indicator_series、coerce_chart_time、pane_id。
• 何も一致しない場合は検索をクリアしてください。索引にはセクションごとにすべてのトピックが並んでいます。
• 複数のトピックにまたがるアイデア（たとえば「ファンダメンタルデータ ＋ on_bar」）には、しばしば2 つの記事が必要です。データの形はファンダメンタルデータで、それがいつ利用できるかはストラテジーのライフサイクルで確認してください。

---

ドキュメントの履歴

アプリ内ドキュメントは、ストラテジーランタイムと並行して保守されています。Python モジュールやバックテストのペイロードが変わると、アプリ内トピックと同梱の Markdown が一緒に更新され、例や名前が同期した状態に保たれます。ストラテジーのインポート例は、一貫してサフィックスなしの quantcraft.* パスで書かれており、古い ide.*_module や quantcraft.*_module のパスは、既存スクリプトを読むための補助としてのみ記載されています。