thinchain

ThinChain

生のブローカーデータとAIトレーディングエージェントをつなぐ触媒です。

実戦で検証済みです。 本番環境のオプション取引アプリから抽出したサニタイズロジックを使用しています。Tradierが本番環境で返してきたあらゆる不正なティックに対応します。

☁️ 本番環境への移行をお考えですか？

オープンソースサーバーは、独自のAPIキーを使ってローカルで実行できます。 複数ブローカーへのフェイルオーバー、SLA保証、 Webhookアラートを備えたホスト型インフラについては、マネージドクラウドのウェイトリストにご登録ください。

問題

TradierのMCPは、500行のJSONチェーンをそのまま出力します。不正な約定値が1つあるだけで、エージェントの推論が乱れる可能性があります。ThinChainは、そのデータがモデルに届く前にサニタイズ、圧縮し、サーキットブレーカーを作動させます。

インストール

git clone https://github.com/snipmcp/thinchain.git
cd thinchain
pip install -e ".[dev]"
cp .env.example .env

またはDockerを使用します。

docker-compose up --build

設定

TRADIER_API_KEY=your_key_here
TRADIER_BASE_URL=https://api.tradier.com/v1
POLYGON_API_KEY=your_key_here
POLYGON_BASE_URL=https://api.polygon.io
DEFAULT_BROKER=tradier
CACHE_TTL_SECONDS=30
LOG_LEVEL=INFO

使用方法

Claude（またはMCP対応エージェント）に送信するプロンプトの例を3つ紹介します。

1. Use get_compressed_chain to get an iron condor setup on SPY expiring 2026-06-19
2. Check if SPY options data is trustworthy before I place my trade
3. Get me the ATM straddle strikes for AAPL expiring 2026-06-19

2つのターミナルで実行する

# Tab 1 — start the MCP server
python -m thinchain.server

# Tab 2 — call a tool from a Python shell or your MCP client
# Tool signatures:
#   get_compressed_chain(symbol, expiration, strategy="raw",
#                        delta_range=None, broker="tradier")
#   get_sanitized_quote(symbol, broker="tradier")
#   get_circuit_status(symbol, expiration, broker="tradier")

仕組み

生のブローカー出力とモデルの間で、3つのレイヤーが処理します。

Broker API → [Sanitize] → [Compress] → [Circuit Break] → MCP Tool → AI Agent
              hygiene     strategy      anomaly gate
              rules       slicing       + cache

• サニタイズ：ゴースト気配値（0.0/0.0）、逆転したスプレッド、NaN／空値／ダッシュ値を除外し、デルタを[-1, 1]に制限し、ロングオプションの正のシータを正規化し、流動性の低い権利行使価格にフラグを付けます。
• 圧縮：チェーンから、戦略（アイアンコンドル、ストラドルなど）に関連する権利行使価格のみを抽出します。通常、トークンを95%以上削減できます。
• サーキットブレーカー：4段階のデータ品質（clean / noisy / degraded / circuit_breaker_active）を使用します。異常な行が65%を超えると、古いデータの提供を拒否し、最後に正常と確認されたキャッシュにフォールバックします。

実際のSPYアイアンコンドル（2026-06-19満期）での実測値

RAW TRADIER PAYLOAD          THINCHAIN OUTPUT
─────────────────────────────────────────────
Rows:        482             Rows:        25
Est tokens:  38,560          Est tokens:  2,000
Token savings:               95%
Anomalous rows removed:      217
Data quality:                noisy → still safely served

ThinChainは482行／38,560トークンを25行／2,000トークンに圧縮し、エージェントのコンテキストを汚染しかねない217件の異常な権利行使価格（流動性不足、ゴースト気配値、広いスプレッド）にフラグを付けます。

ロードマップ

• マネージドクラウドプラン（ホスト型、マルチテナント、Webhookアラート）
• Polygonコネクターの強化（ライブSIPフィード）
• サーキットブレーカー作動時のWebhookアラート

コントリビューション

プルリクエストを歓迎します。提出前にpytestを実行してください。