analyzing-options-flow

オプションフローの分析

概要

中央集権型デリバティブ取引所（Deribit、OKX、Bybit）における暗号資産オプションのフローを追跡・分析し、機関投資家のポジションを特定して、市場センチメントを測定し、BTC および ETH オプション市場の異常な動きを検出します。

前提条件

• 少なくとも1つの暗号資産デリバティブ取引所の API 認証情報（Deribit API キーを推奨。代替として OKX または Bybit）
• requests および websocket-client ライブラリをインストールした Python 3.8 以降
• オプション：フローデータの高度な統計分析用の pandas および numpy
• オプション用語の理解：権利行使価格、満期日、インプライド・ボラティリティ、デルタ、ガンマ、建玉、プレミアム
• リアルタイムのフロー監視用に、取引所の WebSocket フィードへアクセスできるネットワーク環境

手順

1. Read ツールを使用して ${CLAUDE_SKILL_DIR}/config/crypto-apis.env から取引所の API 認証情報を読み込み、デリバティブ取引所のエンドポイントに対して認証します。
2. Bash(crypto:options-*) を実行して Deribit のオプションデータフィードに接続し、BTC または ETH の現在のオプションチェーンを、すべての有効な権利行使価格と満期日を含めて取得します。
3. すべての権利行使価格と満期日の建玉データを取得し、ポジションが集中している箇所を示す建玉ヒートマップを作成します。
4. 出来高および建玉に基づくプット／コール比率を集計して計算し、市場全体のセンチメントを評価します（比率が 1.0 を超える場合は弱気、1.0 を下回る場合は強気を示します）。
5. 設定可能な想定元本のしきい値（例：500K ドル以上）を超えるブロック取引を抽出し、個人投資家のノイズから機関投資家規模の取引を切り分けます。
6. 満期日ごとのインプライド・ボラティリティの期間構造を分析し、ボラティリティの圧縮（ブレイクアウトの可能性が高まっている状態）または拡大（不確実性が高まっている状態）を検出します。
7. まもなく満期を迎えるオプションについて、最も多くのオプションが価値を失って満期を迎える権利行使価格を算出し、満期近くで価格を引き寄せる可能性のある水準として、最大ペインを追跡します。
8. 直近のフローデータを過去の基準値（7日間および30日間の移動平均）と比較し、統計的に異常なポジションを検出します。
9. 強気の大口コール、弱気のプット・スイープ、IV スキューの変化、主要な権利行使価格での建玉増加など、実用的なシグナルを含むフロー概要レポートを生成します。
10. トレーディングダッシュボードやアラートシステムとの連携用に、--format json または --format csv を使用して結果をエクスポートします。

実装ワークフローの全容については、${CLAUDE_SKILL_DIR}/references/implementation.md を参照してください。

出力

• 各契約の権利行使価格、満期日、買値／売値、IV、デルタ、ガンマ、建玉、出来高を示すオプションチェーン表
• プット／コール比率の概要（出来高および建玉別）と過去との比較
• タイムスタンプ、売買方向（買い／売り）、権利行使価格、満期日、数量、プレミアム、インプライド・ボラティリティを記載したブロック取引ログ
• 権利行使価格と満期日の対比でポジション集中を示す建玉ヒートマップデータ
• 満期日ごとの最大ペイン計算結果。最適なペイン権利行使価格とリスクにさらされている金額を含みます
• 期近および期先の満期にわたるインプライド・ボラティリティの期間構造曲線
• 移動平均から2標準偏差を超える取引を検出する異常取引アラート
• 下流の分析やダッシュボード連携用の JSON または CSV エクスポートファイル

エラー処理

エラー	原因	解決策
API Rate Limit Exceeded	デリバティブ取引所 API へのリクエストが多すぎます	呼び出し間隔を最低 100ms にするリクエストスロットリングを実装します。REST エンドポイントへのポーリングではなく、リアルタイムデータには WebSocket フィードを使用します。必要に応じて API プランをアップグレードします
Cannot connect to blockchain node or timeout	オンチェーンの決済データを解決する際に RPC エンドポイントに到達できません	バックアップの RPC エンドポイントに切り替えます。ネットワーク接続を確認し、ノードが完全に同期されていることを確認します
Invalid API key or signature mismatch	取引所 API の認証に失敗しました	取引所で API キーを再生成します。キーの権限にデリバティブデータの読み取りアクセスが含まれていることを確認します。システムクロックの同期を確認します（HMAC 署名には正確なタイムスタンプが必要です）
No options data for instrument	期限切れ、または存在しないオプション契約を照会しました	銘柄名が取引所の命名規則に一致していることを確認します（例：Deribit の場合は BTC-28MAR25-100000-C）。満期日がすでに過ぎていないことを確認します
WebSocket connection dropped	非アクティブ状態またはネットワークの問題により、取引所フィードが切断されました	指数バックオフによる自動再接続を実装します。接続を維持するため、定期的に ping フレームを送信します
Insufficient historical data	統計的な比較に必要な基準期間が短すぎます	ローリングウィンドウを 7 日から 30 日に延長します。履歴を蓄積するのに十分な期間、データ収集パイプラインが稼働していることを確認します

例

BTC オプションのセンチメントスナップショット

# Pull current BTC options chain and compute put/call ratios
python options_flow.py btc --summary

プット／コール比率の集計値、建玉上位 5 つの権利行使価格、最も近い満期日の最大ペイン、現在のアット・ザ・マネーのインプライド・ボラティリティを返します。プット／コール比率が 0.65 で、権利行使価格 120K ドルのコール建玉が大きい場合、機関投資家が強気のポジションを取っていることが示唆されます。

機関投資家のブロック取引を検出する

# Filter for block trades above $1M notional in the last 24 hours
python options_flow.py btc --blocks --min-notional 1000000 --period 24h  # 1000000 = 1M limit

しきい値を超えるすべてのブロック取引を、方向の推定（アグレッサー側）、権利行使価格、満期日、支払プレミアム、約定時の IV とともに一覧表示します。原資産価格が動く前に、大規模な方向性のある賭けを見つけるのに役立ちます。

ETH のインプライド・ボラティリティの期間構造

# Generate IV term structure for ETH across all active expiries
python options_flow.py eth --iv-curve --format json > eth_iv_term.json

IV の期間構造を JSON としてエクスポートします。フラットまたは逆イールドの期間構造（短期 IV が長期 IV より高い状態）は急激な方向性の変動に先行することが多く、右肩上がりの急なカーブは短期的な見通しが穏やかであることを示します。

リソース

• Deribit API ドキュメント -- 暗号資産オプションデータの主要な取引所。WebSocket および REST エンドポイントを提供
• Laevitas Analytics -- オプションフローの可視化機能を備えた暗号資産デリバティブ分析ダッシュボード
• Greeks.live -- 暗号資産オプションのリアルタイム分析とブロック取引の追跡
• Amberdata Derivatives -- 機関投資家向けの暗号資産デリバティブデータ API
• The Block Research -- 集計された暗号資産オプション市場データとチャート