Skip to main content
Use this guide to replace one macro-data feed for a defined country and indicator. Before changing a production feed, identify the country, indicator, date window, and decision the result supports.

​
Map the feed to a route

SEC API does not claim every country, series, calendar, or market representation a broad macro provider may offer. A response demonstrates the requested scope; it does not promise universal coverage.

​
Test one indicator

Compare observation dates, units, source fields, and revisions when provided. Store the retrieval time, requestId, and any returned provenance, freshness, coverage, warning, or status fields.

​
Test the calendar separately

An upcoming event does not establish that an indicator is current, and a current indicator does not establish complete calendar coverage. Surface unavailable, tentative, or degraded conditions to the caller instead of filling gaps with assumptions.

​
Cut over one low-risk read

  1. Dual-run one country and indicator for a defined observation window.
  2. Test the country and series inventory users actually request, including gaps.
  3. Compare timestamps, units, source records, and revision behavior before joining values to a model.
  4. Move one low-risk read behind a reversible control.
  5. Preserve response diagnostics so a stale or unavailable result can be investigated.
Macro observations can inform analysis, but they do not prove a forecast or investment conclusion. Keep modeled interpretation separate from the returned evidence.

​
Next action

Choose one country-indicator window, dual-run it with the current feed, and use the recorded dates, units, coverage, and revisions to decide whether that read can move.

Macro intelligence

Review documented macro workflows and boundaries.

Freshness and trust

Apply timing rules to each result.

Request diagnostics

Capture the context needed to investigate a partial request.