fx_markets

Global risk-on / risk-off indicator

Returns a composite daily risk-sentiment score indicating whether global financial conditions favour risk-on currencies (AUD, NZD, CAD) or risk-off safe havens (JPY, CHF, USD).

The score is derived from four publicly available sources:

  • OFR FSI (U.S. Treasury Office of Financial Research Financial Stress Index) — primary stress gauge, inverted
  • Gold (National Bank of Ukraine official gold price, USD per troy ounce; Narodowy Bank Polski where the NBU did not publish) — safe-haven demand proxy, inverted
  • AUD/USD (European Central Bank euro reference rates, crossed via EUR) — risk-sensitive currency pair
  • USD/JPY (European Central Bank euro reference rates, crossed via EUR) — safe-haven flow proxy

Each component is normalised to a 252-day rolling z-score, weighted, and compressed through tanh to produce a final score in [-1.0, +1.0].

Weights: OFR FSI 40%, Gold 20%, AUD/USD 20%, USD/JPY 20%.

Weights are renormalised over available components and reported as effective_weights. input_dates and input_status describe component observation dates and carry-forward. provisional marks lagged, missing or unknown inputs; complete inputs may also be revised. Recorded changes are available at /v1/risk_sentiment/changes; recording clocks are distinct from publisher publication times.

Query Parameters:

  • start_date: Start date YYYY-MM-DD (default: 365 days ago).
  • end_date: End date YYYY-MM-DD (default: today).

Each data record contains:

  • date: Observation date (YYYY-MM-DD).
  • val: Composite score -1.0 (extreme risk-off) ... +1.0 (extreme risk-on).
  • regime: risk_on (>= 0.25) | neutral | risk_off (<= -0.25).
  • components.ofr_fsi: Normalised (inverted) OFR FSI contribution.
  • components.gold: Normalised (inverted) gold price contribution.
  • components.aud_usd: Normalised AUD/USD contribution.
  • components.usd_jpy: Normalised USD/JPY contribution.
get/v1/risk_sentiment

Request

  • Base URL: https://api.fxmacrodata.com
  • URL: https://api.fxmacrodata.com/v1/risk_sentiment
  • Auth: one of:
    • none
    • API key in header X-API-Key
    • HTTP bearer

Query parameters

start_datestring

Start date YYYY-MM-DD

Example:2025-12-01

Optional query parameter. Start date YYYY-MM-DD

end_datestring

End date YYYY-MM-DD

Example:2026-03-01

Optional query parameter. End date YYYY-MM-DD

limitinteger

Maximum rows to return. Defaults to 20. Maximum 100.

Optional query parameter. Maximum rows to return. Defaults to 20. Maximum 100.

offsetinteger

Number of rows to skip after most-recent-first ordering.

Optional query parameter. Number of rows to skip after most-recent-first ordering.

Response

Risk sentiment time series and component-level contributions.

start_datestring nullable
end_datestring nullable
latest_available_datestring nullable
last_updatedstring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.