Commitment of Traders (COT)
cMindは組み込みのCommitment of Tradersレポート — 米国先物市場での買い建て・売り建ての週次CFTC内訳（商業的ヘッジャー、大型スペキュレーター、ファンド）、インタラクティブな履歴チャート、正規化されたCOTインデックス、cBot向けの認証されたREST API、およびAIクライアント向けのMCPツールを提供します。データはCFTC公開Socrataデータセットから直接取得されます — APIキーなし、集約者なし。経済カレンダーと同様、これはデカップルされたモジュールで、トレーディングコアに影響を与えることなく無効にできます。
What it gives you
- 3つのレポート形式すべて、先物のみと先物+オプション結合:
- Legacy — 非商業（大型スペキュレーター）、商業（ヘッジャー）、報告不可能。
- Disaggregated — 生産者/マーチャント、スワップディーラー、マネージドマネー、その他報告対象。
- Traders in Financial Futures (TFF) — ディーラー、資産マネージャー、レバレッジファンド、その他報告対象。
- キュレーションされた市場カタログ — FXメジャー、金/銀/銅、原油・天然ガス、国債、株価指数、暗号通貨、および主要な穀物/ソフトコモディティ — 各々が安定したCFTC契約コードにマップされ、明確な場合は取引可能なシンボルにマップされます（例：Euro FX →
EURUSD、Gold →XAUUSD）。 - COTインデックス（0–100） — 現在のスペキュレーター純ポジションが履歴範囲内のどこに位置するか（デフォルト~3年のルックバック）。極値に近い読み値は、しばしば反転前となる混雑したポジショニングをフラグします；レポートは長期極値（≥80）または短期極値（≤20）とラベル付けします。
- 特定時点の正確性。 週次レポートは火曜日に測定されますが、翌金曜日にのみ公開になります；すべての読み取りがそのリリース瞬間を尊重するため、バックテストされたポジショニング信号は公開前にレポートを見ることはありません（ルックアヘッドなし）。
Using the page
左ナビゲーションからCommitment of Tradersを開きます。市場とレポートタイプ（Legacy / Disaggregated / Financial）を選択し、Futures + optionsを切り替えて先物のみと結合版の間で切り替えます。ページは以下を表示します：
- 時系列での純ポジショニング — 履歴ウィンドウ全体の各トレーダーカテゴリの純ポジション（買い−売り）のインタラクティブ折れ線グラフ。
- COTインデックス — 0–100インデックスの折れ線グラフ、最新の読み値とその極値ラベル付き。
- 最新スナップショット — トレーダーカテゴリごとの買い/売り/純/建玉%の表、プラス総建玉とレポート日付。
各チャートはズームイン/ズームアウト（およびリセット）ツールバーボタンを備えており、時間軸をドラッグしてズームできます。Export CSVは、選択した市場とレポートタイプの完全な週間履歴をスプレッドシート対応ファイルとしてダウンロードします。Compare marketsを使用して複数の市場を単一のチャート上に重ねます — 比較チャートは各選択市場のスペキュレーター純ポジションとCOTインデックスを並べて表示するため、クロスマーケット・ポジショニングを一目で読むことができます。
How the data flows
データベースはキャッシュです。週次インジェスションワーカーは追跡対象市場の6つのCFTCデータセットを抽出し、市場カタログをアップサート、各新規レポートをべき等的に追加します（再実行はスナップショットを複製しません）。さらに、データはオンデマンドで読み込まれます：市場が最初にリクエストされるとCFTC源から取得されて保存され、その後のすべてのリクエストはデータベースから直接提供されます。キャッシュは新しい週間レポートがリリースされる際に更新されます — 最新の保存されたレポートが1週間以上古くなると、次のリクエストは透過的に最新データを取得して追加します（源がハンマリングされないように制限されます）。最初のロードは数年の履歴をバックフィルします；源の障害は最適なキャッシュデータの提供に低下します。すべてはキーなしでボックスで実行されます；オプションのSocrataアプリトークンはレート制限を上げるだけです。
Configuration
すべてのキーはApp:Cotの下に存在します（feature togglesおよび
white-label owner settingsを参照）：
| Key | Default | Purpose |
|---|---|---|
IngestionEnabled | true | 週次インジェスションワーカーが実行されるかどうか。 |
PollInterval | 6h | ワーカーがCFTCデータセットをポーリングする頻度。 |
BackfillYears | 5 | 最初の実行時に抽出される履歴の年数。 |
ReconcileLookbackWeeks | 4 | 各サイクルで改訂をキャッチするために再同期される最新週数。 |
SocrataAppToken | — | 匿名レート制限を上げるオプショナルトークン。 |
CotIndexLookbackWeeks | 156 | COTインデックス範囲として使用される週次レポート（~3年）。 |
Gating
可視性は経済カレンダーと同じ、2段階ゲート：ホワイトラベルハードゲート
App:Branding:EnableCot（ビルドレベル）およびランタイム機能トグルApp:Features:Cot。どちらかオフの場合、ナビゲーションリンク、ページ、REST API、MCPツールはすべて消えます（APIは404を返します）。データソースはキーレスであるため、データソースキーゲートはありません — 有効は表示可能を意味します。
For developers
- Domain:
Core.Cot—CotMarketおよびCotReport集約、CotPositions値オブジェクト、CotIndexCalculatorドメインサービス、およびICotReports/ICotSourceポート。 - Infrastructure:
Infrastructure.Cot—CftcSocrataSourceアンチコラプション解析、レートゲート、 追記専用書き込みサービス、読み取り側、および週次インジェスションワーカー（EFスキーマcot）。 - cBot & AIアクセス：COT cBot API（REST、
market:readJWT）およびMCPツールCotMarkets、CotLatest、CotHistory、CotHealth。