Skip to main content
SEC API provides allocator-grade macro data from official government sources — not third-party aggregators. Production data is refreshed daily by our scheduled data pipeline at 06:00 UTC.

Coverage

Launch Ring (Tier-1) — All Direct Official

Expansion Ring V1

Source Modes

  • direct_official: Primary runtime fetches directly from the official government agency API or download endpoint. This is the target for all indicators.
  • official_bridge: Official agency data accessed through DBnomics or another bridge. Not acceptable for strict direct-source completion.
  • fallback_harmonized: Non-primary harmonized source (e.g., IMF IFS, World Bank). Not acceptable for strict direct-source completion.

DBnomics Policy

DBnomics is allowed only as a documented runtime fallback after a direct official API attempt fails. It must be visible in observation metadata as a fallback, not as primary provenance.

Endpoints

Search Indicators

Get Observations

Release Calendar

High-Signal Pack (Country Bundle)

Returns the curated set of indicators for a country with source provenance and revision metadata.

Macro Regimes

Returns current macro regime classification per country (expansion, contraction, recovery, overheating).

Production Ownership

Our scheduled data pipeline is the sole scheduled production writer for macro data to the read-optimized analytics store. GitHub Actions workflows are read-only validation only.

Source Provenance

Every observation includes:
  • Source: The official government agency
  • Revision status: Whether this is a preliminary, revised, or final release
  • Release calendar: When the next update is expected
  • Canonicality: Whether the data was fetched directly from the official source or via a bridge
  • Fallback policy: DBnomics is used as fallback only when official APIs are unavailable, and is always annotated in metadata