// API

$ 公開API リファレンス

Shinden の AI 予測データを JSON で取得

// 概要

Shinden の AI 予測データは、認証不要の読み取り専用 JSON API として公開しています。 研究・分析・教育・記事執筆等にご利用いただけます(投資助言ツール等への組み込みは免責事項をご確認ください)。CORS 全開放、レスポンスは 2分(リスト系)〜5分(集計系)キャッシュ。

GET

/api/v1/predictions/latest

3市場すべての本日の最新予測(翌営業日方向)を取得。

// 呼び出し例

curl https://market.itlibra.com/api/v1/predictions/latest

// 応答例

{
  "schema": "v1",
  "generated_at": "2026-05-01T08:30:00.000Z",
  "markets": {
    "USDJPY": {
      "market": { "id": "USDJPY", "name_ja": "ドル円", "name_en": "USD/JPY" },
      "forecast_date": "2026-05-01",
      "predictions": [
        {
          "model_id": "claude-sonnet",
          "model_provider": "anthropic",
          "model_string": "claude-sonnet-4-6",
          "direction": "sideways",
          "confidence": 42,
          "probability": { "up": 30, "sideways": 32, "down": 38 },
          "result": null,
          "permalink": "https://market.itlibra.com/ja/forecasts/USDJPY/2026-05-01#p-..."
        }
      ]
    }
  }
}
GET

/api/v1/predictions/{market}/{date}

特定市場・特定日の全予測詳細(短期 + 中期、根拠と要因含む)を取得。

// パラメータ

  • market USDJPY / N225 / SPX のいずれか
  • date JST の YYYY-MM-DD 形式(予測実行日)

// 呼び出し例

curl https://market.itlibra.com/api/v1/predictions/USDJPY/2026-04-30

// 応答例

{
  "schema": "v1",
  "market": { ... },
  "date": "2026-04-30",
  "count": 6,
  "predictions": [
    {
      "id": "...",
      "horizon": "next_day",
      "model_id": "claude-sonnet",
      "direction": "sideways",
      "confidence": 38,
      "key_reasons": [...],
      "risk_factors": [...],
      "result": {
        "actual_direction": "up",
        "actual_change_pct": 0.45,
        "total_score": -1.0,
        "scoring_rule_version": "v1.0"
      }
    }
  ]
}
GET

/api/v1/rankings

全モデル通算ランキング(全市場合算、平均総合スコア降順)。

// 呼び出し例

curl https://market.itlibra.com/api/v1/rankings

// 応答例

{
  "schema": "v1",
  "scope": "all_time",
  "generated_at": "...",
  "rankings": [
    {
      "rank": 1,
      "model_id": "gpt-mid",
      "display_name": "GPT (Mid Tier)",
      "scored_count": 18,
      "hit_count": 6,
      "hit_rate": 0.333,
      "avg_score": 0.21,
      "overconfidence_rate": 0.0,
      "permalink": "https://market.itlibra.com/ja/models/gpt-mid"
    }
  ]
}

// 利用上の注意

  • 投資助言・売買シグナル提供への利用は 免責事項に従ってください。
  • キャッシュは応答ヘッダの Cache-Control をご確認ください(2-5分程度)。
  • データソース・採点ルール等は 検証方法 データソース を参照。
  • 応答スキーマは v1 で安定。破壊的変更時は新パス(/api/v2/...)を提供します。