---
title: "Executive market briefing"
method: GET
path: "/agent/market-briefing"
---

# Executive market briefing

`GET /agent/market-briefing`

## Request

- Base URL: `https://app.fahaliai.com`
- URL: `https://app.fahaliai.com/agent/market-briefing`
- Auth: none declared

Synthesised market-wide read: risk score, regime, and the notable detections behind them. Fields the underlying subsystems disagreed on are listed in `contradictions` and dropped from the payload rather than averaged — `withheld` and `withheldReasons` name what is missing and why, so a consumer never has to infer absence. Public: no key required.

## Response `200`

Market briefing

- object
  - `schemaVersion` string
  - `status` string: OK or PARTIAL — PARTIAL means subsystems disagreed
  - `contradictions` object[]
  - `withheld` string[]
  - `withheldReasons` object
  - `asOf` string, date-time
  - `marketRiskScore` number
  - `riskLevel` string
  - `marketStateSnapshotId` string
  - `subScores` object[]

## Other responses

- `401`: Missing or invalid API key
- `403`: Key lacks paid scope — response carries an upgrade offer

---

[API](https://skmtc.dev/fahaliai/apis/fahali-intelligence-api.md) · [All operations](https://skmtc.dev/fahaliai/apis/fahali-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fahaliai/apis/fahali-intelligence-api/revisions/d8115da5453f?raw)