supply-demand

name	supply-demand
description	需給分析。信用残高（信用倍率）、空売り比率、投資部門別売買動向から需給バランスを総合判定する。JQuants API v2を使用。

需給分析 Skill

信用取引の残高バランス、空売り比率、投資部門別の売買動向を組み合わせて、銘柄の需給環境を総合判定する。

必要なツールとデータ

• get_stock_price: 現在値と出来高の確認
• JQuants API v2 エンドポイント:
  • /markets/weekly_margin_interest: 週次信用残高（銘柄別）
  • /markets/short_selling: 日次空売り比率（銘柄別）
  • /markets/trades_spec: 投資部門別売買動向（Light プラン以上）
• 最低プラン: Free（信用残・空売り比率）。Light 推奨（投資部門別売買動向）

Workflow Checklist

Supply-Demand Analysis Progress:
- [ ] Step 1: 信用残高データ取得
- [ ] Step 2: 空売り比率データ取得
- [ ] Step 3: 投資部門別売買動向取得（Light+）
- [ ] Step 4: 各指標の分析
- [ ] Step 5: 需給総合判定
- [ ] Step 6: 結果出力

Step 1: 信用残高データ取得

JQuants API /markets/weekly_margin_interest から直近8〜12週分の週次信用残データを取得。

抽出する値:

• margin_buying_balance: 信用買い残高（株数）
• margin_selling_balance: 信用売り残高（株数）
• margin_buying_balance_value: 信用買い残高（金額）
• margin_selling_balance_value: 信用売り残高（金額）

算出:

• 信用倍率 = 信用買い残 / 信用売り残
• 信用買い残の週次変化: 増加中 / 減少中 / 横ばい
• 信用消化日数 = 信用買い残 / 1日平均出来高（大型株では倍率単体より消化日数が重要）

Step 2: 空売り比率データ取得

JQuants API /markets/short_selling から直近20営業日分の空売り比率を取得。

抽出する値:

• short_selling_ratio: 空売り比率（%）
• short_selling_ratio_by_value: 金額ベースの空売り比率

Step 3: 投資部門別売買動向取得（Light+）

JQuants API /markets/trades_spec から投資部門別の売買動向を取得。

主要部門:

• 海外投資家（外国人）
• 個人投資家
• 信託銀行（年金系）
• 投資信託
• 事業法人（自社株買い含む）

注意: このデータは市場全体の動向であり、個別銘柄レベルではない。セクター・市場全体の需給環境の参考として使用する。

Step 4: 各指標の分析

信用倍率の解釈

信用倍率	判定	解説
1.0未満	売り長（需給良好）	踏み上げの可能性
1.0〜3.0	中立〜やや買い長	正常範囲
3.0〜5.0	買い長（やや過剰）	上値が重くなりやすい
5.0超	買い長（需給悪化）	信用買いのしこりが重荷

大型株の場合は消化日数で判断:

消化日数	判定
5日未満	問題なし
5〜15日	やや重い
15日超	上値重い

空売り比率の解釈

空売り比率	判定
30%未満	低い（売り圧力弱い）
30〜40%	通常範囲
40〜50%	やや高い（売り圧力あり）
50%超	高い（ショートカバーの反発余地）

空売り比率のトレンドも重要: 5日移動平均が上昇中か下降中かを確認。

投資部門別のポイント

• 海外投資家が買い越し: 全体相場の追い風
• 海外投資家が売り越し: 全体相場の逆風
• 事業法人が買い越し: 自社株買いの可能性（個別に確認要）
• 個人投資家が売り越し: 逆張り指標として注目（個人の逆が当たりやすい）

Step 5: 需給総合判定

信用倍率	空売り比率	総合判定
低い（〜3.0）	低い（〜40%）	需給良好
低い（〜3.0）	高い（40%+）	需給中立（ショートカバー反発余地あり）
高い（3.0+）	低い（〜40%）	需給やや悪化（信用買いの重荷）
高い（3.0+）	高い（40%+）	需給悪化（売り買い拮抗で膠着しやすい）

週次トレンドの加味:

• 信用買い残が減少トレンド → 需給改善方向
• 信用買い残が増加トレンド → 需給悪化方向（ナンピン買いの可能性）

Step 6: 出力フォーマット

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔄 需給分析レポート
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🏷 銘柄: {銘柄名}（{銘柄コード}）
📅 分析日: {日付}
📊 データ基準日: 信用残={日付}（週次）、空売り比率={日付}（日次）

【信用残高】
| 項目 | 値 | 前週比 |
|------|-----|-------|
| 信用買い残 | {X}千株（{X}百万円） | {+/-X}% |
| 信用売り残 | {X}千株（{X}百万円） | {+/-X}% |
| 信用倍率 | {X.XX}倍 | {+/-X.XX} |
| 消化日数 | {X}日 | - |

  信用買い残トレンド（8週）: {増加中/減少中/横ばい}
  {簡潔な解釈}

【空売り比率】
| 項目 | 値 |
|------|-----|
| 直近 | {X.X}% |
| 5日平均 | {X.X}% |
| 20日平均 | {X.X}% |

  空売りトレンド: {上昇中/低下中/横ばい}
  {簡潔な解釈}

【投資部門別売買動向】← Light+プランのみ
  海外投資家: {買い越し/売り越し}（{X}億円）
  個人投資家: {買い越し/売り越し}（{X}億円）
  信託銀行: {買い越し/売り越し}（{X}億円）
  ※市場全体データ。個別銘柄は間接的な参考

【需給総合判定】
  判定: {需給良好/需給中立/需給やや悪化/需給悪化}
  根拠: {信用倍率、空売り比率、トレンドを組み合わせた説明}
  注目点: {踏み上げの可能性、ショートカバー、ナンピン蓄積等}
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

ISQスコアへの反映

• 需給良好 → ISQ加点（上昇しやすい環境）
• 需給悪化 → ISQ減点（上値が重い環境）
• 信用倍率の急変（前週比で倍率が1.0以上変動）→ 異常シグナルとして深掘りリサーチのトリガー