---
title: "Get structured market verdict"
method: GET
path: "/agent/verdict"
---

# Get structured market verdict

`GET /agent/verdict`

## Request

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

Returns direction (bullish/bearish/neutral), confidence score, reasoning chain, expected move percentage, and forecast horizon for one or more symbols. Optionally includes contagion risk data.

## Query parameters

- `symbols` string
- `includeContagion` boolean

## Response `200`

Market verdict intelligence

- object
  - `schemaVersion` '1.0'
  - `updatedAt` string, date-time
  - `count` integer
  - `data` SpectraIntelligence[]
    - `symbol` string, required
    - `timestamp` string, date-time, required
    - `verdict` SpectraVerdict, required
      - `direction` 'bullish' | 'bearish' | 'neutral' | 'unknown', required
      - `confidence` number, required
      - `uncertainty` number, required
      - `expectedMovePct` number, nullable
      - `forecastHorizon` '12h' | '24h' | '72h' | '7d' | '30d', required
      - `severity` 'critical' | 'high' | 'moderate' | 'low', required
      - `urgencyScore` number, required
    - `reasoning` SpectraReasoning, required
      - `steps` string[], required
      - `toolsUsed` string[], required
      - `conflictScore` number, required
      - `missingSignals` string[], required
      - `cycleCount` integer, required
    - `capitalFlow` SpectraCapitalFlow
      - `netFlowUsd` number, nullable, required
      - `direction` 'buy_side' | 'sell_side' | 'balanced' | 'withheld' | 'null', nullable, required
      - `confidence` number, nullable, required: Uncalibrated unusualness score, not measurement presence or probability.
      - `trend` 'withheld', required
    - `contagion` SpectraContagion
      - `risk` 'critical' | 'high' | 'moderate' | 'low', required
      - `confidence` number, required
      - `affectedSymbols` object[], required
        - `symbol` string
        - `correlation` number
        - `expectedImpactPct` number
        - `timeToMaterializeHours` number
    - `action` SpectraAction
      - `type` 'hold' | 'reduce' | 'increase' | 'exit' | 'hedge' | 'watch', required
      - `targetExposure` number, nullable
      - `timeframe` 'immediate' | '24h' | '72h' | '7d', required
      - `rationale` string, required
    - `provenance` SpectraProvenance, required
      - `source` 'predictions' | 'alerts' | 'agent_verdict' | 'derived', required
      - `modelVersion` string, required
      - `engineNames` string[], required
      - `walkForwardValidated` boolean, required
      - `dataAsOf` string, date-time, required
    - `aiMetadata` SpectraAiMetadata, required
      - `schemaVersion` '1.0', required
      - `reasoningTrace` boolean, required
      - `confidenceNormalized` boolean, required
      - `schemaStable` boolean, required
      - `lastModelRetrain` string, date, nullable

## Other responses

- `503`: Database not ready

---

[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)