stockbee-exhaustion-hammer-screener

Stockbee Exhaustion Hammer Screener

Stockbee 方式の売り枯れハンマー候補を対象に、米国株をスクリーニングします。このスキルは候補の生成とセットアップ品質の評価を行うワークフローであり、シグナル配信サービスや自動執行システムではありません。

使用するタイミング

• Stockbee／Pradeep Bonde 方式の売り枯れセットアップのスクリーニングを依頼されたとき
• 大引け間際のハンマー／長い下ヒゲを伴う反転候補を探したいとき
• 押し目を付け、売り枯れが見られる可能性のある、強く流動性の高い銘柄をスキャンしたいとき
• 大引け前または大引け後に、下抜け後の奪回候補を探したいとき
• スクリーニング対象として、銘柄リスト、ユニバースファイル、または過去／暫定の OHLCV JSON が提供されたとき
• 候補出力を technical-analyst、position-sizer、trader-memory-core、または stockbee-setup-fluency-trainer に渡したいとき

前提条件

• ライブのユニバースおよび過去の OHLCV をスクリーニングするには、FMP API キーが必要です。

  export FMP_API_KEY=your_api_key_here
  

• 任意の API 不使用モード：銘柄ごとの日次 OHLCV バーを含む --prices-json を指定します。想定される大引け間際の用途では、最新のバーは大引け間際に取得した当日分の暫定バーである必要があります。
• 任意の --profiles-json を使用すると、marketCap、mutualFundHolders、institutionalHolders、institutionalOwnershipPct などの品質メタデータを追加できます。
• マーケットレジームのワークフローで新たなスイングリスクが許可された後にのみ実行するか、出力を手動レビュー専用として扱ってください。

ワークフロー

ステップ 1：入力モードを選択する

次の 3 つのモードから選択します。

モード A：FMP ユニバーススキャン

python3 skills/stockbee-exhaustion-hammer-screener/scripts/screen_exhaustion_hammer.py \
  --fmp-universe \
  --max-symbols 300 \
  --market-gate allowed \
  --output-dir reports/

モード B：銘柄を明示的に指定

python3 skills/stockbee-exhaustion-hammer-screener/scripts/screen_exhaustion_hammer.py \
  --symbols APP ENPH NVDA TSLA \
  --market-gate allowed \
  --output-dir reports/

モード C：オフライン／大引け間際の OHLCV JSON

python3 skills/stockbee-exhaustion-hammer-screener/scripts/screen_exhaustion_hammer.py \
  --prices-json data/near_close_daily_ohlcv.json \
  --profiles-json data/quality_profiles.json \
  --market-gate allowed \
  --output-dir reports/

FMP を使って大引け間際に可能な限りのスクリーニングを行う場合は、クオートのオーバーライドを使用してください。銘柄ごとにクオートの呼び出しが 1 回追加で必要になり、データ提供元の更新状況に左右されます。

python3 skills/stockbee-exhaustion-hammer-screener/scripts/screen_exhaustion_hammer.py \
  --fmp-universe \
  --use-quote-latest \
  --max-api-calls 700 \
  --market-gate allowed \
  --output-dir reports/

ステップ 2：スクリーニングを実行する

スクリプトは、次のセットアップ群を検出します。

• 売り枯れハンマー： 長い下ヒゲ、小さな実体、高い終値位置、および当日安値からの回復
• 下抜け／奪回ハンマー： 当日安値が直近の短期安値を下抜け、大引け間際の価格がその水準を奪回
• 過去のモメンタムに続く押し目： 設定されたルックバック期間内に直近高値を付け、その後、長期下降トレンドではなく、制御された押し目が発生
• 高品質／高流動性の状況： 株価、出来高、20 日平均売買代金、時価総額のメタデータ、および任意の保有者メタデータ

次に、以下を使ってセットアップの品質をスコアリングします。

• 品質／流動性
• 過去のモメンタム
• 押し目と売り枯れの状況
• ハンマー足の形状
• 当日安値にバッファを加えた値までのリスク幅
• 市場ゲートとの整合性

ステップ 3：出力を確認する

生成された JSON レポートと Markdown レポートを確認します。各候補について、次の情報を提示してください。

• トリガーの種類と一致したタグすべて
• 直近高値からの押し目の深さと、その高値からの日数
• 下抜け／奪回の状況と短期の直近安値
• ハンマーの形状：下ヒゲ、実体、上ヒゲ、終値位置、安値からの回復
• 出来高比率、平均売買代金、品質メタデータ
• エントリーの基準値、ストップの基準値、ストップまでのリスク率
• セットアップのスコア、評価、状態、除外理由
• 推奨される後続アクション

ステップ 4：選別した候補をトレード計画に回す

出力は慎重に使用してください。

• A／A- 候補： チャートを手動で検証し、決算／ニュースのリスクを確認してから、position-sizer に渡します
• B 候補： 手動でレビューするか、翌日にハンマー高値を確認します
• ウォッチ候補： ウォッチリスト／モデルブックに残し、値動きの継続またはより小さなリスク幅を待ちます
• 除外候補： 事後分析用に保管し、執行には使用しません

出力

• stockbee_exhaustion_hammer_YYYY-MM-DD_HHMMSS.json - 候補リスト、メタデータ、しきい値、スコアの内訳、除外銘柄を含む構造化データ
• stockbee_exhaustion_hammer_YYYY-MM-DD_HHMMSS.md - 評価／状態ごとにまとめた、人が読みやすいレポート

リソース

• references/exhaustion_hammer_methodology.md - Stockbee スタイルの手法の概要と実装範囲
• references/scoring_system.md - コンポーネントの重み、状態のしきい値、失敗判定フィルター
• references/near_close_operations.md - 大引け間際の運用チェックリストとスケジュールに関する注意事項

共通 FMP クライアント

FMP のライブアクセスでは、同梱されている生成済みの scripts/fmp_client.py を使用します。これは FMP の実行開始時にのみ読み込まれるため、オフラインモードは requests がなくても動作します。CLI キーと環境変数の優先順位、API 呼び出しの予算、成功時の出力形式は維持されます。リクエストには安定版エンドポイントのみを使用します。安定版リクエストが拒否された場合、空の結果を返した場合、または失敗した場合に、廃止済みの v3 URL へフォールバックすることはありません。共通クライアントは、キーがそのまま、または URL エンコードされた状態で出力に含まれるのを防ぎ、不正な JSON を 1 回再試行します。また、429 は 60 秒待機後に最大 1 回再試行し、再度レート制限された場合は処理を停止します。

株価の上書きでは安定版の /quote を読み込みます。デフォルトのバーの日付には、履歴ウィンドウと一致する America/New_York の暦日を使用します。