How macro data flows.
Process language, no vendor names. We aggregate from canonical official-agency channels, an aggregator passthrough layer, and a delivery-pipe redundancy peer — categorized by source_type in every response.
Source ladder · three tiers
Tier 1
Primary
Official-agency channels pulled at the release timestamp via armed-poll. Ground truth for every covered indicator.
Tier 2
Aggregator passthrough
Long-tail catalog mirroring official series with backfilled history. Used for breadth, vintage archaeology, and cross-check.
Tier 3
Redundancy peer
Independent delivery pipe. Speed-and-redundancy only; backstops Tier 1 if it lags. Disagreement above threshold trips a breaker.
source_type enum · what each category covers
| Enum value | What it covers |
|---|---|
| official_release | Numbers published by a national statistical bureau at a scheduled release time. Includes headline + revision vintages where the publisher provides them. |
| central_bank | Policy-rate decisions, balance-sheet stocks, and reserve-aggregate readings published directly by a monetary authority. |
| aggregator | A series sourced through a long-tail catalog layer that mirrors a primary publisher. Used for breadth and revision history. |
| survey | Sentiment, expectations, and consensus indices compiled from periodic respondent panels. Sample-based; carries respondent-count metadata. |
| prediction_market | Probabilities implied by exchange-traded contracts on discrete future events. Mark-to-last-trade; freshness drops as the contract approaches resolution. |
| analyst_consensus_proxy | An opaque consensus-of-forecasts surface used where a primary consensus feed is not contracted. Surfaced via meta.degradation: consensus_unavailable when null. |
| equity_index_proxy | Implied-volatility and equity-index-derived gauges sourced through an opaque public-data layer. Mark-to-close for daily series; intraday tickers may carry coarser cadence. |
| unknown | Fallback label applied when the upstream channel has not been classified or has rotated. Triggers a manual-review queue for the next ingest cycle. |
Cadence · armed-poll
Cron-driven. Calendar-armed at the release tick.
For scheduled releases an armed-poll routine spins up at T−60s and drops to a one-second cadence between T−5s and T+45s. Once the publisher's bytes resolve, the result is written, signed, and propagated to the edge. Off-window, the cron returns to its idle per-class cadence.
Multi-source disagreement and output-stale breakers run on every write. Tripping either pages an operator within 60 seconds; the response surface degrades to the last good vintage.