The entire forecast engine.
One API call.

{
  "symbol": "XAUUSD",
  "timeframe": "H1",
  "anchor_utc": "2026-07-02T16:00:00Z",
  "horizon_hours": 48,
  "candles": [
    { "t": "2026-07-02T16:00:00Z", "kind": "forming",
      "o": 4139.72, "h": 4148.10, "l": 4131.65, "c": 4137.62,
      "dir_prob": 0.46, "sigma": 8.41 },
    { "t": "2026-07-02T17:00:00Z", "kind": "future",
      "o": 4137.62, "h": 4145.98, "l": 4129.90, "c": 4135.11,
      "dir_prob": 0.44, "sigma": 9.12 },
    "… 46 more candles …"
  ],
  "summary": { "bias_pct": -0.52, "p_up_end": 0.29, "confidence_sigma": 4.12 }
}

{
  "symbol": "XAUUSD",
  "written_at": "2026-09-20T04:00:00Z",
  "stance": "neutral", "confidence": 45, "risk": "medium",
  "headline": "Fed hawkishness lifts dollar; gold forecast flat despite rate risk",
  "summary": "Warsh's accommodation language pushed the 2-year yield and the
              dollar higher, typically headwinds for gold. Yet the model
              predicts almost no movement over the next 24 hours…",
  "risk_note": "If real yields spike further, gold could break below 4513.",
  "levels": [
    { "side": "support",    "kind": "caution",     "level": 4513.13, "from": 4508.74, "to": 4517.52,
      "label": "Support 4513.13",
      "why": "A break below this level would invalidate the flat view." },
    { "side": "resistance", "kind": "opportunity", "level": 4573.52, "from": 4569.13, "to": 4577.91,
      "label": "Resistance 4573.52", "why": "…" }
  ],
  "key_levels": {                       // every real H1 swing level the briefing could pick from
    "atr": 17.57,
    "support":    [ { "price": 4513.13, "touches": 4, "hours_ago": 21 }, … ],
    "resistance": [ { "price": 4573.52, "touches": 5, "hours_ago": 5 },  … ]
  },
  "live_alert": { "kind": "caution", "from": 4508.74, "to": 4517.52,
                  "price_when_reached": 4512.20, "since": "2026-09-20T06:12:00Z" },
  "drivers":  [ { "title": "2-year yield and dollar spike", "impact": "bearish" } ],
  "sources":  [ "ActionForex", "Federal Reserve — Press releases" ],
  "forecast": { "anchor": 4544.06, "predicted_low": 4513.13, "predicted_high": 4573.52 }
}