{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/audioalpha-io/json-schema/audioalpha-io-market-snapshot-schema.json",
  "title": "MarketSnapshot",
  "x-generated": "2026-11-02",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/audioalpha-io-openapi.json#/components/schemas/MarketSnapshot",
  "type": "object",
  "properties": {
    "snapshot_date": {
      "type": "string",
      "description": "Date of the snapshot",
      "format": "date"
    },
    "status": {
      "type": "string",
      "description": "Generation status of the parent daily snapshot. \"completed\" once the snapshot has finished generating (the normal case); \"writing\" while it is being (re)generated, typically during the 00:00–00:01 UTC build window. Always present in the response."
    },
    "version_num": {
      "type": "integer",
      "description": "Revision number of this snapshot. 1 = first generation, higher = later revision. Only present when version_info=true."
    },
    "version_label": {
      "type": "string",
      "description": "Human-readable label for this version (e.g. \"eod_utc\", \"backfill\", \"revised\"). Only present when version_info=true."
    },
    "regime": {
      "type": "string",
      "description": "Current market regime"
    },
    "regime_justification": {
      "type": "string",
      "description": "Explanation of the regime classification"
    },
    "market_sentiment_mean": {
      "type": "number",
      "description": "α-sentiment mean across all episodes (0-10 scale, higher = more bullish)"
    },
    "market_sentiment_median": {
      "type": "number",
      "description": "α-sentiment median across all episodes (0-10 scale)"
    },
    "market_sentiment_std": {
      "type": "number",
      "description": "Standard deviation of α-sentiment scores"
    },
    "sentiment_open": {
      "type": "number",
      "description": "α-sentiment of first podcast of the day (0-10 scale)"
    },
    "sentiment_high": {
      "type": "number",
      "description": "Highest α-sentiment of last podcast of the day (0-10 scale)"
    },
    "sentiment_low": {
      "type": "number",
      "description": "Lowest α-sentiment of the day (0-10 scale)"
    },
    "sentiment_close": {
      "type": "number",
      "description": "α-sentiment at market close (0-10 scale)"
    },
    "sentiment_delta_1d": {
      "type": "number",
      "description": "Change in α-sentiment vs yesterday (-10 to +10)"
    },
    "sentiment_delta_7d": {
      "type": "number",
      "description": "Change in α-sentiment vs 7 days ago (-10 to +10)"
    },
    "episode_count": {
      "type": "integer",
      "description": "Number of podcast episodes analyzed"
    },
    "consensus_score": {
      "type": "number",
      "description": "Agreement among podcast hosts (0-1, higher = more agreement)"
    },
    "sentiment_zscore": {
      "type": "number",
      "description": "α-sentiment standard deviations from historical mean (-3 to +3)"
    },
    "sentiment_strength_index": {
      "type": "number",
      "description": "Strength of the α-sentiment signal"
    },
    "headline": {
      "type": "string",
      "description": "Headline summarizing the day"
    },
    "daily_narrative_summary": {
      "type": "string",
      "description": "Narrative summary of the day's discussions"
    },
    "market_psychology_summary": {
      "type": "string",
      "description": "Analysis of market psychology from podcast content"
    },
    "delta_narrative": {
      "type": "string",
      "description": "Explanation of recent market changes"
    },
    "key_tensions": {
      "type": "array",
      "description": "Key market tensions identified in podcast discussions",
      "items": {
        "type": "object"
      }
    },
    "surprise_mentions": {
      "type": "array",
      "description": "Unexpected or surprising topics that emerged",
      "items": {
        "type": "object"
      }
    },
    "wordcloud": {
      "type": "object",
      "description": "Word frequency data for visualization"
    }
  }
}