Skip to content
Docs
Get API key
Tools

Forecast Tools

Trading Economics forecasts for economic indicators and market prices.

Forecast fields

get_forecast and get_market_forecast return their projections in a structured Forecasts field. Each entry contains:

FieldDescription
ValueThe projected value.
PeriodEndThe date the value refers to, as YYYY-MM-DD.
CalendarPeriodThe calendar quarter of PeriodEnd, for example "Q1 2027"; null when PeriodEnd is not the end of a calendar quarter.
HorizonPositionThe position of the entry within the forecast horizon (1 = nearest). It is not a calendar quarter; use CalendarPeriod or PeriodEnd to determine when a value applies.

When present, UnresolvedFields lists the forecast values that were omitted because their period could not be determined.

get_forecast

Forecasts for economic indicators.

Returns Trading Economics forecasts for economic indicators in one of four modes, resolved in this priority order:

  1. Ticker mode: one or more series, by ticker.
  2. Country and indicator mode: specific indicators for specific countries.
  3. Country mode: all indicator forecasts for one or more countries.
  4. Indicator mode: one or more indicators across all countries.
ParameterTypeRequiredDefaultAllowed values / formatDescription
tickerstringConditional—Trading Economics tickers, comma-separatedFor example "usurtot" or "usurtot,wgdpchin". Takes priority over country and indicator.
countrystring or string[]Conditional—Country namesFor example "mexico" or ["mexico", "sweden"].
indicatorstring or string[]Conditional—Indicator namesFor example "gdp" or ["gdp", "population"].

Example

“What are the GDP forecasts for Mexico and Sweden?”

JSON
{ "country": ["mexico", "sweden"], "indicator": "gdp" }
Example response
JSON
{
  "columns": ["Country", "Category", "Title", "LatestValue", "LatestValueDate", "ForecastLastUpdate", "Frequency", "Unit", "HistoricalDataSymbol", "Forecasts", "YearEndForecasts"],
  "rows": [
    ["Mexico", "GDP", "Mexico GDP", 1832.64, "2025-12-31T00:00:00", "2026-10-01T00:01:00", "Yearly", "USD Billion", "WGDPMEXI", [], [{ "Year": 2026, "Value": 1856 }, { "Year": 2027, "Value": 1888 }, { "Year": 2028, "Value": 1924 }]],
    ["Sweden", "GDP", "Sweden GDP", 669, "2025-12-31T00:00:00", "2026-10-01T00:01:00", "Yearly", "USD Billion", "WGDPSWED", [], [{ "Year": 2026, "Value": 687.73 }, { "Year": 2027, "Value": 704.24 }, { "Year": 2028, "Value": 714.1 }]]
  ]
}

Retrieved on October 26, 2026; complete response. Values change over time. GDP is a yearly indicator, so Forecasts is empty and the projections are in YearEndForecasts.

Returns

For each series, Country, Category, Title, LatestValue, LatestValueDate, ForecastLastUpdate, Frequency, Unit and HistoricalDataSymbol, with:

  • Forecasts: the projected values, described in Forecast fields.
  • YearEndForecasts: the forecasts for the end of the current calendar year and the two following years, each with Year and Value.

Notes

  • At least one of ticker, country or indicator is required.
  • Forecasts can be empty for indicators with a yearly frequency; use YearEndForecasts instead.

get_forecast_updates

Which indicator forecasts were updated, and when.

Returns the indicator forecasts that were recently updated, without the forecast values.

ParameterTypeRequiredDefaultAllowed values / formatDescription
countrystringNo—Country nameFor example "albania".
startDatestringNo—YYYY-MM-DDReturns the updates on or after this date.

Example

“Which forecasts were updated since October 1, 2026?”

JSON
{ "startDate": "2026-10-01" }
Example response
JSON
{
  "columns": ["Country", "Category", "Ticker", "LastUpdate"],
  "rows": [
    ["Kuwait", "Loans to Private Sector", "KUWAITLTPS", "2026-10-26T12:15:00"],
    ["Pakistan", "Interbank Rate", "PAKISTANINTRAT", "2026-10-26T12:15:00"]
  ]
}

Retrieved on October 26, 2026; truncated to 2 of 6,487 rows. Values change over time.

Returns

Country, Category, Ticker, LastUpdate (UTC).

Notes

  • Provide at most one of country or startDate. Without either, all recent updates are returned.
  • To retrieve the forecast values, pass Ticker to get_forecast.

get_market_forecast

Price forecasts for markets.

Returns Trading Economics price forecasts for a market category (stock indices, currencies, commodities, cryptocurrencies or government bonds) or for specific symbols.

ParameterTypeRequiredDefaultAllowed values / formatDescription
categorystring (enum)Noindexindex, currency, commodity, crypto, bondThe market category.
symbolsstringNo—Market symbols, comma-separatedFor example "DAX:IND" or "AAPL:US,DAX:IND". Takes priority over category.

Example

“What are the price forecasts for commodities?”

JSON
{ "category": "commodity" }
Example response
JSON
{
  "columns": ["Symbol", "Name", "Country", "Date", "Type", "Last", "Unit", "URL", "Importance", "Forecasts"],
  "rows": [
    ["CL1:COM", "Crude Oil", "commodity", "2026-10-26T14:25:53.083", "commodity", 100.8673, "USD/Bbl", "/commodity/crude-oil", 1, [
      { "HorizonPosition": 1, "Value": 106.898217, "PeriodEnd": "2026-12-31", "CalendarPeriod": "Q4 2026" },
      { "HorizonPosition": 2, "Value": 113.101304, "PeriodEnd": "2027-03-31", "CalendarPeriod": "Q1 2027" },
      { "HorizonPosition": 3, "Value": 118.357747, "PeriodEnd": "2027-06-30", "CalendarPeriod": "Q2 2027" },
      { "HorizonPosition": 4, "Value": 123.862038, "PeriodEnd": "2027-09-30", "CalendarPeriod": "Q3 2027" }
    ]],
    ["CO1:COM", "Brent", "commodity", "2026-10-26T14:26:14.143", "commodity", 114.964, "USD/Bbl", "/commodity/brent-crude-oil", 2, [
      { "HorizonPosition": 1, "Value": 120.582651, "PeriodEnd": "2026-12-31", "CalendarPeriod": "Q4 2026" },
      { "HorizonPosition": 2, "Value": 127.16644, "PeriodEnd": "2027-03-31", "CalendarPeriod": "Q1 2027" },
      { "HorizonPosition": 3, "Value": 132.733984, "PeriodEnd": "2027-06-30", "CalendarPeriod": "Q2 2027" },
      { "HorizonPosition": 4, "Value": 138.558312, "PeriodEnd": "2027-09-30", "CalendarPeriod": "Q3 2027" }
    ]]
  ]
}

Retrieved on October 26, 2026; truncated to 2 of 103 rows. Values change over time.

Returns

For each instrument, Symbol, Name, Country, Type, Last (the latest price), Unit, Date, URL and Importance, with the projected values in Forecasts, described in Forecast fields.

Notes

  • When symbols is provided, category is ignored. Without either, the forecasts for stock indices are returned.