factors

Get a precomputed FX factor for one currency

Returns a factor series for one explicit currency and one explicit factor. Factor values are precomputed snapshots; component macro indicators are not recalculated per request.

Path Parameters:

  • currency: Three-letter currency code, for example EUR or USD.
  • factor: Factor slug. Currently supported: monetary_stance.

Query Parameters:

  • start_date / end_date: Optional date window. With no dates, the latest snapshot is returned.
  • include_components: Include component scores and input values.
  • include_sources: Include FXMacroData source endpoint URLs.

Use /v1/data_catalogue/{currency}?include_capabilities=true for factor discovery metadata.

Authentication: USD factor data is public without an API key. Anonymous requests are subject to a 100 requests/day per-IP fair-use limit. Other currencies require an Individual or Business API key sent in the X-API-Key header.

get/v1/factors/{currency}/{factor}

Request

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

Path parameters

currency'AUD' | 'CAD' | 'CHF' | 'EUR' | 'GBP' | 'JPY' | 'NZD' | 'USD' required
Example:AUD

Required path parameter. Allowed values: AUD, CAD, CHF, EUR, GBP, JPY, NZD, USD.

factor'monetary_stance' required

Factor slug, for example monetary_stance.

Example:monetary_stance

Required path parameter. Factor slug, for example monetary_stance. Allowed values: monetary_stance.

Query parameters

start_datestring

Inclusive start date YYYY-MM-DD. With no dates, returns latest only.

Example:2026-01-01

Optional query parameter. Inclusive start date YYYY-MM-DD. With no dates, returns latest only.

end_datestring

Inclusive end date YYYY-MM-DD. Defaults to today when start_date is supplied.

Example:2026-07-19

Optional query parameter. Inclusive end date YYYY-MM-DD. Defaults to today when start_date is supplied.

include_componentsboolean

Include component scores and source observations.

Optional query parameter. Include component scores and source observations.

include_sourcesboolean

Include FXMacroData source endpoint URLs.

Optional query parameter. Include FXMacroData source endpoint URLs.

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.

api_keystring

Your Individual or Business API key

Deprecated: legacy query-string API key. Still accepted so existing integrations keep working, but new integrations must send the key in the X-API-Key header (or Authorization: Bearer). A key is required for non-USD, paid-only, or full-history requests. Responses to requests authenticated this way carry a Deprecation header.

Response

Successful Response

currencystring required
factorstring required
methodologystring required
as_ofstring nullable
scorenumber nullable
level_scorenumber nullable
impulse_scorenumber nullable
rate_repricing_scorenumber nullable
macro_pressure_scorenumber nullable
labelstring nullable
stance_contextstring nullable
latest_available_datestring nullable
last_updatedstring nullable
start_datestring required
end_datestring required

Changes

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