ticker | The stock ticker symbol, uppercased (e.g. “AAPL”). |
as_of_date | The calendar date the score reflects, in YYYY-MM-DD format. |
price | The underlying price at the snapshot, or null when unavailable. |
score | The composite sentiment score, 0-100 (100 = greed-side), as the equal-weight mean of the scored components. Null when no component cleared its data gates. |
band | The band label for the score: “extreme fear”, “fear”, “neutral”, “greed”, or “extreme greed” (cutoffs versioned in methodology). Null when the score is null. |
coverage | How many components were scored, as “N/7” over the v1 component set. |
sub_scores | The mean score within each group (trend, flow, and positioning), each null when no component in that group was scored. |
components | The scored components, each with: id, group, raw (today’s value), unit, percentile (0-100 vs the ticker’s own window), score (oriented so 100 = greed-side), the reference window, and an optional note when an interim source was substituted. |
omitted | Components dropped from the composite, each with the component id and the reason (history_accumulating, thin_chain, insufficient_history, or no_data), so a degraded score is always explained. |
delta | Change in the composite over 1, 5, and 20 trading days (d1/d5/d20), each computed on today’s component set so the comparison is like-for-like. Null when the prior anchor was not computable. |
history | Weekly composite closes (oldest first), each with its date, score, and coverage at that point. |
flags | Notable transitions on this snapshot (e.g. entered_extreme_fear, crossed_below_125d_ma, flow_positioning_divergence). |
context | Event context: next_earnings carries the upcoming earnings date, days until it, and whether it is confirmed (null when no upcoming date is known). |
derived | Quotable plain-English sentences summarizing the score, its drivers, and any caveats. The first sentence doubles as a headline. |
scope | What the options-derived components saw: selection (full_chain or partial_chain when the fetch cap stopped at a prefix), contracts_analyzed, expirations_covered, and pages_fetched. |
data_quality | Reading reliability: status (“ok”, “degraded” when components were omitted, or “no_data”), history (status and days_collected for the trailing daily series), and an optional note. |
methodology | A versioned description of the scoring: component_scoring, composite, band_cutoffs (the four ascending thresholds between the five band labels), orientation, and flow_sharing. |
