Skip to main content

​
Macro Intelligence

Datastream provides a structured macro surface covering indicator time series, release history, forward estimates, regime classification, and curated high-signal country packs. All endpoints return requestId and traceparent for observability.

​
Macro indicators

Time series observations by country and indicator. Each observation carries revision-aware provenance and country-quality metadata sourced from official statistical agencies.

​
GET /v1/macro/indicators

ParameterTypeDefaultDescription
indicatorstringrequiredIndicator key (alias: indicator_key)
countrystringUSISO country code
limitnumber—Maximum observations returned
refreshbooleanfalseForce upstream refresh
curl -H "x-api-key: $OMNI_DATASTREAM_API_KEY" \
  -H "omni-version: 2026-03-19" \
  "https://api.secapi.ai/v1/macro/indicators?country=US&indicator=GDP"

​
Macro releases

Release history with actual, prior, consensus, and surprise metadata for a given country. Optionally filter to a single indicator.

​
GET /v1/macro/releases

ParameterTypeDefaultDescription
countrystringUSISO country code
indicatorstring—Filter to a specific indicator key (alias: indicator_key)
limitnumber—Maximum releases returned
refreshbooleanfalseForce upstream refresh
curl -H "x-api-key: $OMNI_DATASTREAM_API_KEY" \
  -H "omni-version: 2026-03-19" \
  "https://api.secapi.ai/v1/macro/releases?country=US&indicator=CPI"

​
Macro calendar

Upcoming macro events for a country, including official-source releases and central-bank events.

​
GET /v1/macro/calendar

ParameterTypeDefaultDescription
countrystringUSISO country code
daysnumber—Look-ahead window in days
refreshbooleanfalseForce upstream refresh
curl -H "x-api-key: $OMNI_DATASTREAM_API_KEY" \
  -H "omni-version: 2026-03-19" \
  "https://api.secapi.ai/v1/macro/calendar?country=US&days=14"

​
Macro forecasts

Forward estimates with methodology metadata. Optionally scope to a single indicator and control the number of forecast horizons returned.

​
GET /v1/macro/forecasts

ParameterTypeDefaultDescription
countrystringUSISO country code
indicatorstring—Filter to a specific indicator key (alias: indicator_key)
horizonsnumber—Number of forward horizons to return
refreshbooleanfalseForce upstream refresh
curl -H "x-api-key: $OMNI_DATASTREAM_API_KEY" \
  -H "omni-version: 2026-03-19" \
  "https://api.secapi.ai/v1/macro/forecasts?country=US&indicator=GDP&horizons=4"

​
High-signal packs

Curated country packs containing the highest-signal macro series with explicit source provenance, fallback posture, and release-calendar metadata. Each pack is scoped to a single country and returns the full set of configured series.

​
Supported countries

CountryCodeSeries countNotes
United StatesUS24Daily and weekly FRED series
ChinaCN15
JapanJP17
TaiwanTW—
IsraelIL—
CanadaCA—
United KingdomGB—
EurozoneEZ—
South KoreaKR—
BrazilBR—
IndiaIN—
Saudi ArabiaSA—

​
GET /v1/macro/high-signal-pack

ParameterTypeDefaultDescription
countrystringJPISO country code (see supported countries above)
refreshbooleanfalseForce upstream refresh
curl -H "x-api-key: $OMNI_DATASTREAM_API_KEY" \
  -H "omni-version: 2026-03-19" \
  "https://api.secapi.ai/v1/macro/high-signal-pack?country=US"

​
Macro regime classification

Returns the current macro regime classification for a country using the canonical Datastream macro overlay. The regime reflects the aggregate positioning across growth, inflation, and monetary-policy dimensions.

​
GET /v1/macro/regimes

ParameterTypeDefaultDescription
countrystringUSISO country code
lookbackstring—Lookback period (e.g. 6m, 1y)
curl -H "x-api-key: $OMNI_DATASTREAM_API_KEY" \
  -H "omni-version: 2026-03-19" \
  "https://api.secapi.ai/v1/macro/regimes?country=US"

​
Country reports

Returns an intelligence bundle covering the prior period’s macro path, likely drivers, and forward view for a country. This is a POST endpoint that accepts a JSON body.

​
POST /v1/intelligence/country-report

ParameterTypeDefaultDescription
countrystringUSISO country code (2-12 characters)
lookbackstring—Lookback period (e.g. 6m, 1y; 2-12 characters)
curl -X POST \
  -H "x-api-key: $OMNI_DATASTREAM_API_KEY" \
  -H "omni-version: 2026-03-19" \
  -H "content-type: application/json" \
  -d '{"country": "US"}' \
  "https://api.secapi.ai/v1/intelligence/country-report"

​
Failure posture

  • treat non-2xx responses as contract-aware failures, not free-form errors
  • preserve requestId and traceparent in logs and downstream reports
  • if provenance or freshness metadata is present, return it unchanged so trust is not lost in the handoff