Predictions API contract
Not every forecast is a market consensus
Eight kinds of number can answer “what is expected for this release?”, and they are not interchangeable. A central bank’s own projection, a survey of forecasters, an options-implied probability and a statistical nowcast have different accuracy, different horizons and different revision behaviour. prediction_class tells you which one you are holding.
Filter on this
prediction_class
How the number was produced. Two of the eight classes represent professional consensus. Household and business expectations have their own class.
Never a consensus
fxmacrodata
Our own estimate, generated for every confirmed release. Useful, but do not present it as a market consensus.
Availability
Set by the publisher, not by your plan
Many releases have no compiled consensus from any official source. Where none exists, no subscription adds one.
Request the exact forecast class you need
Filter the dedicated endpoint instead of treating an unfiltered first result as consensus. prediction_class is the field to filter on; the older prediction_type still works unchanged for existing clients.
GET https://api.fxmacrodata.com/v1/predictions/gbp/inflation
?prediction_class=compiled_consensus
&pre_release_only=true
X-API-Key: YOUR_API_KEYUse prediction_source for a specific provider or publication, and prediction_source_label for display. The source slug and label describe the forecast source; they do not guarantee a source URL.
An empty result tells you why it is empty
A filtered request that matches nothing still returns HTTP 200. The availability block on every response lists which classes have a publishing source for that pair at all, and why the class you asked for came back empty, so you never have to guess whether the gap is your plan, your date range, or the data itself.
"availability": {
"classes_with_sources": ["model_nowcast", "institutional_projection", "fxmacrodata"],
"returned_classes": [],
"reason": { "compiled_consensus": "no_source_for_pair" }
}| reason | What it means |
|---|---|
| no_source_for_pair | No publisher produces this class of forecast for this currency and indicator. A property of the data, not of your plan: no subscription adds it. |
| outside_requested_window | A source covers this pair but published nothing inside your date range and series selection. Widen the dates. |
| outside_freemium_window | A source covers this pair, but the matching rows fall outside the history window available to this request. |
| values_require_key | A source covers this pair, and forecast values need a plan. Only ever returned alongside the full source list, so you can see what a plan would unlock before buying one. |
Check coverage before you buy a key
Forecast values need a plan on every currency, USD included. Which publishers cover which indicator does not: /v1/predictions/coverage is free and needs no key. It returns the publisher behind every indicator, the prediction_class each one produces, whether any of them is a genuine consensus, and the verified archive floor where we have probed it. It returns no forecast values.
curl https://api.fxmacrodata.com/v1/predictions/coverage
curl https://api.fxmacrodata.com/v1/predictions/coverage/usdA forecast request made without a key answers 401 carrying the same catalogue for the pair you asked for, so a refusal still tells you whether the gap is your plan or the data. If a publisher is not listed there, no subscription adds it.
Inspect how each historical forecast was captured
predictions[].provenance distinguishes a forecast stored by FXMacroData when its model ran from a historical value imported later from an official publisher archive. It also states what generated_at is based on, the source timestamp precision, whether later data was used to reconstruct the value, and which vintages the feed retains.
capture_mode=stored_at_generation
FXMacroData model output archived by the live generation workflow. The durable US CPI and employment-series model archive currently begins with August 2026 reference periods; older model outputs are unavailable, not recreated.
capture_mode=retrospective_official_archive_import
A publisher's genuine historical forecast value imported later by FXMacroData. Cleveland Fed history is in this category: it is not a current-model reconstruction, but FXMacroData did not capture it in real time. The feed keeps the final pre-release point per target month and uses a date-based known-at marker.
An absent provenance object is not an assurance: it means that source's ingest semantics have not yet been audited for this public field. See the point-in-time guide for the full history and pagination contract.
Prediction class reference
Every class answers the same question in a different way. Only the two marked consensus of forecasters represent what a group of people expects; other classes distinguish household and business expectations, institutional projections, models and market prices.
| prediction_class | What it is | Produced by | Customer label |
|---|---|---|---|
| compiled_consensusConsensus of forecasters | An official publisher's compilation of independent forecasters' estimates. The target period and statistic are the publisher's own; an annual or quarterly forecast is not a forecast for each monthly release. | many independent forecasters, aggregated by a publisher | Compiled consensus |
| forecaster_surveyConsensus of forecasters | A survey of professional forecasters or financial-market participants, published by an official institution or its commissioned survey producer. Its respondent population, forecast horizon and publication vintage remain explicit. | surveyed forecasters, aggregated by the surveying institution | Forecaster survey |
| expectations_survey | A survey of households, businesses, labour organisations or a combined non-professional panel. It describes that population's expectations, rather than professional-economist consensus. | the published household, business or combined panel | Business and household expectations |
| market_implied | Derived from traded instrument prices, usually options or futures. It reflects what the market is priced for, not what any person forecast. | traded prices | Market implied |
| model_nowcast | A statistical model's estimate of the current period, published and maintained by a central bank or reserve bank. Updated continuously as inputs arrive; no human forecast is involved. | a published statistical model | Model nowcast |
| central_bank_projection | A central bank's own published projection for the variable, from a monetary policy report, staff projection round or equivalent official publication. | the central bank itself | Central-bank projection |
| institutional_projection | A projection published by a multilateral or national institution that is not the currency's central bank, such as the IMF or the OECD. Typically annual and revised a few times per year. | a multilateral or national institution | Institutional projection |
| fxmacrodata | An FXMacroData-generated estimate combining central-bank guidance, survey consensus, historical trends and recent prints. It is our number, not a market consensus, and must never be presented as one. | FXMacroData | FXMacroData forecast |
Legacy prediction_type values
Every response still carries prediction_type, and it still works as a filter, so nothing built against it breaks. It grew one value at a time per source and ended up splitting instruments that are the same thing: the ECB and Philadelphia Fed Surveys of Professional Forecasters landed in market_consensus and survey respectively, and imf_weo names a publisher rather than a category. prediction_class is the field to build on.
| Legacy prediction_type | Now reported as |
|---|---|
| market_consensus | compiled_consensus or forecaster_survey, depending on the source |
| survey | forecaster_survey |
| market_prediction | market_implied |
| model_nowcast | model_nowcast |
| central_bank_forecast | central_bank_projection |
| central_bank_projection | central_bank_projection |
| imf_weo | institutional_projection |
| oecd_eo | institutional_projection |
| fxmacrodata | fxmacrodata |
Source-labelled forecast coverage
Every currency/indicator pair below carries at least one external, source-labelled forecast feed. The FXMacroData Blended Forecast (prediction_source=fxmacrodata_blended) is additionally generated for every confirmed release-calendar announcement across all supported currencies, so it is not repeated per row. Where a pair has been verified against the production archive, its pre-release history depth is shown; unverified pairs should still be probed with pre_release_only=true before production use.
aud 4 indicators with external forecasts
| Indicator | Forecast source | prediction_class | Verified pre-release history |
|---|---|---|---|
| inflation |
OECD Economic Outlook (oecd_eo) RBA Market Economists' Forecasts (Table J1) (rba_j1) |
institutional_projection compiled_consensus |
Not yet verified — probe with pre_release_only=true
|
| trimmed_mean_inflation |
RBA Market Economists' Forecasts (Table J1) (rba_j1) |
compiled_consensus |
Not yet verified — probe with pre_release_only=true
|
| policy_rate |
RBA Market Economists' Forecasts (Table J1) (rba_j1) |
compiled_consensus |
Not yet verified — probe with pre_release_only=true
|
| unemployment |
OECD Economic Outlook (oecd_eo) RBA Market Economists' Forecasts (Table J1) (rba_j1) |
institutional_projection compiled_consensus |
Not yet verified — probe with pre_release_only=true
|
brl 7 indicators with external forecasts
| Indicator | Forecast source | prediction_class | Verified pre-release history |
|---|---|---|---|
| inflation |
BCB Focus Market Readout (bcb_focus) OECD Economic Outlook (oecd_eo) |
compiled_consensus institutional_projection |
Not yet verified — probe with pre_release_only=true
|
| unemployment |
BCB Focus Market Readout (bcb_focus) OECD Economic Outlook (oecd_eo) |
compiled_consensus institutional_projection |
Not yet verified — probe with pre_release_only=true
|
|
inflation_mom
Served on the inflation endpoint via ?frequency=mom |
BCB Focus Market Readout (bcb_focus) |
compiled_consensus |
Not yet verified — probe with pre_release_only=true
|
| gdp |
BCB Focus Market Readout (bcb_focus) |
compiled_consensus |
Not yet verified — probe with pre_release_only=true
|
| policy_rate |
BCB Focus Market Readout (bcb_focus) |
compiled_consensus |
Not yet verified — probe with pre_release_only=true
|
| trade_balance |
BCB Focus Market Readout (bcb_focus) |
compiled_consensus |
Not yet verified — probe with pre_release_only=true
|
| current_account_balance |
BCB Focus Market Readout (bcb_focus) |
compiled_consensus |
Not yet verified — probe with pre_release_only=true
|
cad 4 indicators with external forecasts
| Indicator | Forecast source | prediction_class | Verified pre-release history |
|---|---|---|---|
| inflation |
Bank of Canada Monetary Policy Report (bank_of_canada) Bank of Canada Market Participants Survey (boc_market_participants_survey) OECD Economic Outlook (oecd_eo) |
central_bank_projection forecaster_survey institutional_projection |
Not yet verified — probe with pre_release_only=true
|
| gdp |
Bank of Canada Monetary Policy Report (bank_of_canada) |
central_bank_projection |
Not yet verified — probe with pre_release_only=true
|
| policy_rate |
Bank of Canada Market Participants Survey (boc_market_participants_survey) |
forecaster_survey |
Not yet verified — probe with pre_release_only=true
|
| unemployment |
OECD Economic Outlook (oecd_eo) |
institutional_projection |
Not yet verified — probe with pre_release_only=true
|
chf 2 indicators with external forecasts
| Indicator | Forecast source | prediction_class | Verified pre-release history |
|---|---|---|---|
| inflation |
OECD Economic Outlook (oecd_eo) SECO Expert Group on Business Cycles Forecast (seco) |
institutional_projection institutional_projection |
Not yet verified — probe with pre_release_only=true
|
| unemployment |
OECD Economic Outlook (oecd_eo) |
institutional_projection |
Not yet verified — probe with pre_release_only=true
|
cnh 2 indicators with external forecasts
| Indicator | Forecast source | prediction_class | Verified pre-release history |
|---|---|---|---|
| inflation |
IMF World Economic Outlook (imf_weo) OECD Economic Outlook (oecd_eo) |
institutional_projection institutional_projection |
Not yet verified — probe with pre_release_only=true
|
| unemployment |
IMF World Economic Outlook (imf_weo) |
institutional_projection |
Not yet verified — probe with pre_release_only=true
|
cny 1 indicator with external forecasts
| Indicator | Forecast source | prediction_class | Verified pre-release history |
|---|---|---|---|
| inflation |
OECD Economic Outlook (oecd_eo) PBoC Monetary Policy Report (pboc_monetary_policy_report) |
institutional_projection central_bank_projection |
Not yet verified — probe with pre_release_only=true
|
dkk 2 indicators with external forecasts
| Indicator | Forecast source | prediction_class | Verified pre-release history |
|---|---|---|---|
| inflation |
Danmarks Nationalbank Forecast (danmarks_nationalbank) OECD Economic Outlook (oecd_eo) |
central_bank_projection institutional_projection |
Not yet verified — probe with pre_release_only=true
|
| unemployment |
OECD Economic Outlook (oecd_eo) |
institutional_projection |
Not yet verified — probe with pre_release_only=true
|
eur 3 indicators with external forecasts
| Indicator | Forecast source | prediction_class | Verified pre-release history |
|---|---|---|---|
| inflation |
ECB/Eurosystem Staff Macroeconomic Projections (ecb_staff_projections) ECB Survey of Professional Forecasters (ecb_survey_of_professional_forec) OECD Economic Outlook (oecd_eo) |
central_bank_projection forecaster_survey institutional_projection |
From 1999-03-01 — Quarterly targets (Mar/Jun/Sep/Dec): full ECB/Eurosystem staff projection vintage path since the March-1999 (W99) exercise, plus the ECB SPF rolling one-year-ahead round since 1999-Q1. Non-quarter months carry no consensus. (checked 2026-09-02) |
| core_inflation |
ECB/Eurosystem Staff Macroeconomic Projections (ecb_staff_projections) ECB Survey of Professional Forecasters (ecb_survey_of_professional_forec) |
central_bank_projection forecaster_survey |
From 2017-09-01 — Quarterly targets: SPF core-HICP rounds since 2017 (the SPF only began surveying core then); staff HEF projection vintages from the June-2023 exercise. (checked 2026-09-02) |
| unemployment |
ECB/Eurosystem Staff Macroeconomic Projections (ecb_staff_projections) ECB Survey of Professional Forecasters (ecb_survey_of_professional_forec) OECD Economic Outlook (oecd_eo) |
central_bank_projection forecaster_survey institutional_projection |
From 1999-11-01 — Quarterly targets (Feb/May/Aug/Nov SPF cadence): every SPF round since 1999-Q1; staff URX projection vintages from the June-2023 exercise. Other months carry no consensus. (checked 2026-09-02) |
gbp 3 indicators with external forecasts
| Indicator | Forecast source | prediction_class | Verified pre-release history |
|---|---|---|---|
| inflation |
HM Treasury Forecasts for the UK Economy (hm_treasury) OECD Economic Outlook (oecd_eo) |
compiled_consensus institutional_projection |
Not yet verified — probe with pre_release_only=true
|
| unemployment |
HM Treasury Forecasts for the UK Economy (hm_treasury) OECD Economic Outlook (oecd_eo) |
compiled_consensus institutional_projection |
Not yet verified — probe with pre_release_only=true
|
| policy_rate |
HM Treasury Forecasts for the UK Economy (hm_treasury) |
compiled_consensus |
Not yet verified — probe with pre_release_only=true
|
huf 2 indicators with external forecasts
| Indicator | Forecast source | prediction_class | Verified pre-release history |
|---|---|---|---|
| inflation |
IMF World Economic Outlook (imf_weo) |
institutional_projection |
Not yet verified — probe with pre_release_only=true
|
| unemployment |
IMF World Economic Outlook (imf_weo) |
institutional_projection |
Not yet verified — probe with pre_release_only=true
|
ils 2 indicators with external forecasts
| Indicator | Forecast source | prediction_class | Verified pre-release history |
|---|---|---|---|
| inflation |
IMF World Economic Outlook (imf_weo) OECD Economic Outlook (oecd_eo) |
institutional_projection institutional_projection |
Not yet verified — probe with pre_release_only=true
|
| unemployment |
IMF World Economic Outlook (imf_weo) OECD Economic Outlook (oecd_eo) |
institutional_projection institutional_projection |
Not yet verified — probe with pre_release_only=true
|
jpy 3 indicators with external forecasts
| Indicator | Forecast source | prediction_class | Verified pre-release history |
|---|---|---|---|
| inflation |
IMF World Economic Outlook (imf_weo) OECD Economic Outlook (oecd_eo) |
institutional_projection institutional_projection |
Not yet verified — probe with pre_release_only=true
|
| gdp |
IMF World Economic Outlook (imf_weo) |
institutional_projection |
Not yet verified — probe with pre_release_only=true
|
| unemployment |
OECD Economic Outlook (oecd_eo) |
institutional_projection |
Not yet verified — probe with pre_release_only=true
|
krw 2 indicators with external forecasts
| Indicator | Forecast source | prediction_class | Verified pre-release history |
|---|---|---|---|
| gdp |
Bank of Korea Economic Outlook (bank_of_korea) |
central_bank_projection |
Not yet verified — probe with pre_release_only=true
|
| inflation |
Bank of Korea Economic Outlook (bank_of_korea) |
central_bank_projection |
Not yet verified — probe with pre_release_only=true
|
myr 2 indicators with external forecasts
| Indicator | Forecast source | prediction_class | Verified pre-release history |
|---|---|---|---|
| inflation |
IMF World Economic Outlook (imf_weo) |
institutional_projection |
Not yet verified — probe with pre_release_only=true
|
| unemployment |
IMF World Economic Outlook (imf_weo) |
institutional_projection |
Not yet verified — probe with pre_release_only=true
|
ngn 2 indicators with external forecasts
| Indicator | Forecast source | prediction_class | Verified pre-release history |
|---|---|---|---|
| inflation |
IMF World Economic Outlook (imf_weo) |
institutional_projection |
Not yet verified — probe with pre_release_only=true
|
| unemployment |
IMF World Economic Outlook (imf_weo) |
institutional_projection |
Not yet verified — probe with pre_release_only=true
|
nok 4 indicators with external forecasts
| Indicator | Forecast source | prediction_class | Verified pre-release history |
|---|---|---|---|
| inflation |
Norges Bank Monetary Policy Report (norges_bank) Norges Bank Expectations Survey (norges_bank_expectations_survey) OECD Economic Outlook (oecd_eo) |
central_bank_projection forecaster_survey institutional_projection |
Not yet verified — probe with pre_release_only=true
|
| unemployment |
OECD Economic Outlook (oecd_eo) |
institutional_projection |
Not yet verified — probe with pre_release_only=true
|
| policy_rate |
Norges Bank Monetary Policy Report (norges_bank) |
central_bank_projection |
Not yet verified — probe with pre_release_only=true
|
| core_inflation |
Norges Bank Monetary Policy Report (norges_bank) |
central_bank_projection |
Not yet verified — probe with pre_release_only=true
|
nzd 3 indicators with external forecasts
| Indicator | Forecast source | prediction_class | Verified pre-release history |
|---|---|---|---|
| inflation |
OECD Economic Outlook (oecd_eo) RBNZ Monetary Policy Statement (rbnz_mps) RBNZ Survey of Expectations (M14) (rbnz_survey_of_expectations) |
institutional_projection central_bank_projection forecaster_survey |
Not yet verified — probe with pre_release_only=true
|
| unemployment |
OECD Economic Outlook (oecd_eo) RBNZ Monetary Policy Statement (rbnz_mps) RBNZ Survey of Expectations (M14) (rbnz_survey_of_expectations) |
institutional_projection central_bank_projection forecaster_survey |
Not yet verified — probe with pre_release_only=true
|
| policy_rate |
RBNZ Survey of Expectations (M14) (rbnz_survey_of_expectations) |
forecaster_survey |
Not yet verified — probe with pre_release_only=true
|
pen 3 indicators with external forecasts
| Indicator | Forecast source | prediction_class | Verified pre-release history |
|---|---|---|---|
| inflation |
BCRP Macroeconomic Expectations Survey (bcrp_expectations_survey) BCRP Reporte de Inflación (bcrp_reporte_de_inflación) OECD Economic Outlook (oecd_eo) |
forecaster_survey central_bank_projection institutional_projection |
Not yet verified — probe with pre_release_only=true
|
| unemployment |
OECD Economic Outlook (oecd_eo) |
institutional_projection |
Not yet verified — probe with pre_release_only=true
|
| gdp |
BCRP Macroeconomic Expectations Survey (bcrp_expectations_survey) BCRP Reporte de Inflación (bcrp_reporte_de_inflación) OECD Economic Outlook (oecd_eo) |
forecaster_survey central_bank_projection institutional_projection |
Not yet verified — probe with pre_release_only=true
|
sek 5 indicators with external forecasts
| Indicator | Forecast source | prediction_class | Verified pre-release history |
|---|---|---|---|
| inflation |
OECD Economic Outlook (oecd_eo) Sveriges Riksbank Monetary Policy Report (sveriges_riksbank) |
institutional_projection central_bank_projection |
Not yet verified — probe with pre_release_only=true
|
| unemployment |
OECD Economic Outlook (oecd_eo) Sveriges Riksbank Monetary Policy Report (sveriges_riksbank) |
institutional_projection central_bank_projection |
Not yet verified — probe with pre_release_only=true
|
| employment |
Sveriges Riksbank Monetary Policy Report (sveriges_riksbank) |
central_bank_projection |
Not yet verified — probe with pre_release_only=true
|
| gdp |
Sveriges Riksbank Monetary Policy Report (sveriges_riksbank) |
central_bank_projection |
Not yet verified — probe with pre_release_only=true
|
| policy_rate |
Sveriges Riksbank Monetary Policy Report (sveriges_riksbank) |
central_bank_projection |
Not yet verified — probe with pre_release_only=true
|
thb 3 indicators with external forecasts
| Indicator | Forecast source | prediction_class | Verified pre-release history |
|---|---|---|---|
| inflation |
IMF World Economic Outlook (imf_weo) OECD Economic Outlook (oecd_eo) |
institutional_projection institutional_projection |
Not yet verified — probe with pre_release_only=true
|
| unemployment |
IMF World Economic Outlook (imf_weo) OECD Economic Outlook (oecd_eo) |
institutional_projection institutional_projection |
Not yet verified — probe with pre_release_only=true
|
| gdp |
OECD Economic Outlook (oecd_eo) |
institutional_projection |
Not yet verified — probe with pre_release_only=true
|
twd 2 indicators with external forecasts
| Indicator | Forecast source | prediction_class | Verified pre-release history |
|---|---|---|---|
| inflation |
IMF World Economic Outlook (imf_weo) |
institutional_projection |
Not yet verified — probe with pre_release_only=true
|
| unemployment |
IMF World Economic Outlook (imf_weo) |
institutional_projection |
Not yet verified — probe with pre_release_only=true
|
usd 15 indicators with external forecasts
| Indicator | Forecast source | prediction_class | Verified pre-release history |
|---|---|---|---|
|
inflation_qoq_saar
Served on the inflation endpoint via ?seasonality=sa&frequency=qoq&annualization=saar |
Philadelphia Fed Survey of Professional Forecasters (philly_fed_spf) |
forecaster_survey |
Not yet verified — probe with pre_release_only=true
|
|
core_inflation_qoq_saar
Served on the core_inflation endpoint via ?seasonality=sa&frequency=qoq&annualization=saar |
Philadelphia Fed Survey of Professional Forecasters (philly_fed_spf) |
forecaster_survey |
Not yet verified — probe with pre_release_only=true
|
| inflation |
Cleveland Fed Inflation Nowcasting (cleveland_fed_nowcast) OECD Economic Outlook (oecd_eo) |
model_nowcast institutional_projection |
From 2013-08-31 — Every monthly release (Cleveland Fed archive floor: Aug 2013 reference) (yoy, mom) (checked 2026-09-02) |
| core_inflation |
Cleveland Fed Inflation Nowcasting (cleveland_fed_nowcast) |
model_nowcast |
From 2013-08-31 — Every monthly release (Cleveland Fed archive floor: Aug 2013 reference) (yoy, mom) (checked 2026-09-02) |
|
inflation_mom
Served on the inflation endpoint via ?frequency=mom |
Cleveland Fed Inflation Nowcasting (cleveland_fed_nowcast) |
model_nowcast |
Not yet verified — probe with pre_release_only=true
|
|
core_inflation_mom
Served on the core_inflation endpoint via ?frequency=mom |
Cleveland Fed Inflation Nowcasting (cleveland_fed_nowcast) |
model_nowcast |
Not yet verified — probe with pre_release_only=true
|
| pce |
Cleveland Fed Inflation Nowcasting (cleveland_fed_nowcast) FOMC Summary of Economic Projections (fomc_sep) New York Fed Survey of Market Expectations (ny_fed_sme) |
model_nowcast central_bank_projection forecaster_survey |
From 2013-07-31 — Every monthly release (Cleveland Fed archive floor: Jul 2013 reference). FOMC SEP adds annual Q4/Q4 projection vintages from 2019; NY Fed SME adds three annual December targets. No official source publishes a per-release monthly consensus. (checked 2026-09-10) |
| core_pce |
Cleveland Fed Inflation Nowcasting (cleveland_fed_nowcast) FOMC Summary of Economic Projections (fomc_sep) New York Fed Survey of Market Expectations (ny_fed_sme) |
model_nowcast central_bank_projection forecaster_survey |
From 2013-07-31 — Every monthly release (Cleveland Fed archive floor: Jul 2013 reference). FOMC SEP adds annual Q4/Q4 projection vintages from 2019; NY Fed SME adds one annual December target. No official source publishes a per-release monthly consensus. (checked 2026-09-10) |
|
pce_mom
Served on the pce endpoint via ?frequency=mom |
Cleveland Fed Inflation Nowcasting (cleveland_fed_nowcast) |
model_nowcast |
Not yet verified — probe with pre_release_only=true
|
| policy_rate |
Atlanta Fed Market Probability Tracker (atlanta_fed_market_probability_tracker) FOMC Summary of Economic Projections (fomc_sep) |
market_implied central_bank_projection |
From 2023-09-20 — Sparse: roughly three FOMC meetings per year. For a deeper FOMC consensus series use policy_rate_midpoint. (checked 2026-09-02) |
| unemployment |
FOMC Summary of Economic Projections (fomc_sep) New York Fed Survey of Market Expectations (ny_fed_sme) OECD Economic Outlook (oecd_eo) |
central_bank_projection forecaster_survey institutional_projection |
From 2015-12-31 — Year-end (December) releases only: full FOMC SEP median vintage path (2 vintages for the 2015 target rising to 14 for recent targets, 124 in total) since 2015; NY Fed SME adds vintages from 2023. No official source publishes per-release monthly consensus. (checked 2026-09-03) |
|
gdp_growth_q4_yoy
Q4-over-Q4 GDP growth variant of the gdp family |
Atlanta Fed GDPNow (atlanta_fed_gdpnow) FOMC Summary of Economic Projections (fomc_sep) New York Fed Survey of Market Expectations (ny_fed_sme) New York Fed Staff Nowcast (ny_fed_staff_nowcast) |
model_nowcast central_bank_projection forecaster_survey model_nowcast |
Not yet verified — probe with pre_release_only=true
|
|
policy_rate_midpoint
Separate indicator slug: the target-range midpoint, not the policy_rate upper bound |
New York Fed Survey of Market Expectations (ny_fed_sme) |
forecaster_survey |
From 2023-07-26 — Most FOMC meetings since 2023-07: NY Fed Survey of Market Expectations target-range consensus, with Atlanta Fed market-implied probabilities on the meetings it covers. (checked 2026-09-02) |
| average_hourly_earnings | From None — No official publisher carries a pre-release forecast for this series: not the Philadelphia Fed SPF, not the FOMC SEP, not the Cleveland Fed nowcast. The data array carries FXMacroData's own forecast alone, and no plan adds a source. (checked 2026-09-10) | ||
| non_farm_payrolls | From 2003-11-24 — Quarterly survey rounds only: 92 dated SPF vintages since 2003-11 for nonfarm payroll employment and average monthly payroll change, served in the official_forecasts array on the publisher's own quarterly-average basis. No official source publishes a per-release monthly consensus, so the data array carries FXMacroData's own forecast alone. (checked 2026-09-10) |
A pair absent from this matrix has no declared external announcement forecast; native survey coverage is listed separately below — for example, historical event-specific market consensus is not available for USD non-farm payrolls, average hourly earnings, PPI, or retail sales. The blended forecast still covers those releases going forward, and there is no other endpoint, plan, or export route that unlocks additional historical consensus rows.
Official survey and forecast publishers
Browse published forecast periods, statistics and respondent groups on the Consensus and forecasts dashboard. Forecast values require an active subscription. Surveys of households or businesses are labelled separately from professional consensus.
BRL — 1 publishers
- BCB Focus Market Readout — Compiled consensus
bcb_focus
PEN — 1 publishers
- BCRP Macroeconomic Expectations Survey — Forecaster survey
bcrp_expectations
MYR — 1 publishers
- Bnm Economic Outlook — Central-bank projection
bnm_economic_outlook
CAD — 3 publishers
- Bank of Canada Market Participants Survey — Forecaster survey
boc_market_participants - Boc Mpr Native — Central-bank projection
boc_mpr_native - Finance Canada Survey of Private Sector Economists — Compiled consensus
canada_finance_survey
GBP — 2 publishers
- Bank of England Market Participants Survey — Forecaster survey
boe_maps - HM Treasury Forecasts for the UK Economy — Compiled consensus
hmt_native_compilation
ILS — 2 publishers
- Bank of Israel Professional Forecaster Compilation — Compiled consensus
boi_professional_forecasts - Cbs Israel Business Expectations — Business and household expectations
cbs_israel_business_expectations
KRW — 2 publishers
- Bok Consumer Inflation Expectations — Business and household expectations
bok_consumer_inflation_expectations - Bank of Korea Professional Inflation Expectations — Forecaster survey
bok_professional_inflation_expectations
THB — 1 publishers
- Bot Economic Outlook — Central-bank projection
bot_economic_outlook
DKK — 1 publishers
- Danmarks Nationalbank Native — Central-bank projection
danmarks_nationalbank_native
TWD — 1 publishers
- Dgbas Economic Forecast — Institutional projection
dgbas_economic_forecast
EUR — 2 publishers
- ECB Survey of Monetary Analysts — Forecaster survey
ecb_sma - ECB Survey of Professional Forecasters — Forecaster survey
ecb_spf
USD — 4 publishers
- FOMC Summary of Economic Projections — Central-bank projection
fomc_sep - New York Fed Survey of Market Expectations — Forecaster survey
ny_fed_sme - Philadelphia Fed Livingston Survey — Forecaster survey
philly_fed_livingston - Philadelphia Fed Survey of Professional Forecasters — Forecaster survey
philly_fed_spf
CHF — 2 publishers
- KOF Consensus Forecast — Forecaster survey
kof_consensus_forecast - SECO Expert Group on Business Cycles Forecast — Institutional projection
seco_native_forecasts
JPY — 1 publishers
- Meti Production Forecast — Business and household expectations
meti_production_forecast
HUF — 1 publishers
- Mnb Native Forecasts — Central-bank projection
mnb_native_forecasts
CNY — 1 publishers
- Nbs Business Expectations — Business and household expectations
nbs_business_expectations
CNH — 1 publishers
- Nbs Business Expectations — Business and household expectations
nbs_business_expectations
NOK — 2 publishers
- Norges Bank Expectations Survey — Forecaster survey
norges_bank_expectations_native - Ssb Economic Trends — Institutional projection
ssb_economic_trends
AUD — 2 publishers
- RBA Market Economists' Forecasts (Table J1) — Compiled consensus
rba_j1 - Rba Staff Forecasts — Central-bank projection
rba_staff_forecasts
NZD — 2 publishers
- Rbnz Mps Projections — Central-bank projection
rbnz_mps_projections - RBNZ Survey of Expectations (M14) — Forecaster survey
rbnz_survey_of_expectations
SEK — 2 publishers
- Riksbank Native Projections — Central-bank projection
riksbank_native_projections - Riksbank / Origo Inflation Expectations — Forecaster survey
riksbank_origo_expectations
Join forecast to actual
Each prediction group includes announcement_id. Match it to the same field from /v1/announcements/{currency}/{indicator}. The realised value is normally data[].val. For USD NFP, val is the total payroll-employment level and change is the official monthly jobs gain or loss; current NFP predictions target the level. Request revisions=all when you need revision history; do not infer revisions from a later overwrite.
GET https://api.fxmacrodata.com/v1/announcements/usd/inflation
?revisions=all
X-API-Key: YOUR_API_KEYUnderstand official source links
source_url is optional. When present on an announcement, source_url_scope tells you whether it points to the exact release, the broader dataset, or the underlying series. Do not promise an exact BLS, BEA, or other official release permalink for every event.
For a customer-facing citation, show the link only when it is present and label its scope honestly. The forecast source fields are separate from the announcement's official source fields.
Run the coverage preflightOfficial forecasts in their own periods
Central-bank projections and official forecaster surveys retain their published quarters, calendar years and survey horizons in the official_forecasts array. Each row includes prediction_class, target_period, period_basis, unit, the original source_url and publication precision. Unknown publication dates remain empty; a date without a release time does not establish an intraday availability timestamp. The prediction_class, prediction_source, start_date and end_date filters apply to this array; official_limit caps its rows (default 500, 0 omits them).
Read a source in its original forecast periods
Select a source on the currency endpoint to retrieve its native variables, including forecasts without a matching announcement series. Use variable, target_period, statistic, respondent_population, prediction_class or publication_precision to narrow the result. Set limit to at most 1,000 and pass official_forecast_next_cursor as before_id for the next page.
GET https://api.fxmacrodata.com/v1/predictions/jpy
?prediction_source=meti_production_forecast
&limit=100
X-API-Key: YOUR_API_KEYofficial_forecast_calendar lists verified publication times for the selected forecast source, with its official schedule evidence. These are forecast-publication events; the economic announcements being forecast have their own release calendar. A source with no confirmed future time returns an empty forecast calendar.
GET /v1/predictions/usd/unemployment?prediction_class=forecaster_survey&start_date=2024-01-01Example: the Philadelphia Fed Survey of Professional Forecasters gives dated medians for the unemployment rate, payroll change, CPI, core CPI, PCE and core PCE for the survey quarter and the next four, with vintages back to 1990.
Production preflight
- 1. Check the coverage matrix above, then confirm each required pair with a live query.
- 2. If a consensus is mandatory, filter
prediction_class=compiled_consensusorforecaster_survey, and read theavailabilityblock when the result is empty. - 3. Check several upcoming and recent releases, not one sample row.
- 4. Verify
source_urlandsource_url_scopeseparately. - 5. Confirm revision and history needs on the announcements endpoint.
- 6. Design a clear unavailable state for missing optional fields.