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:
| Field | Description |
|---|---|
Value | The projected value. |
PeriodEnd | The date the value refers to, as YYYY-MM-DD. |
CalendarPeriod | The calendar quarter of PeriodEnd, for example "Q1 2027"; null when PeriodEnd is not the end of a calendar quarter. |
HorizonPosition | The 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:
- Ticker mode: one or more series, by ticker.
- Country and indicator mode: specific indicators for specific countries.
- Country mode: all indicator forecasts for one or more countries.
- Indicator mode: one or more indicators across all countries.
| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
ticker | string | Conditional | — | Trading Economics tickers, comma-separated | For example "usurtot" or "usurtot,wgdpchin". Takes priority over country and indicator. |
country | string or string[] | Conditional | — | Country names | For example "mexico" or ["mexico", "sweden"]. |
indicator | string or string[] | Conditional | — | Indicator names | For example "gdp" or ["gdp", "population"]. |
Example
“What are the GDP forecasts for Mexico and Sweden?”
{ "country": ["mexico", "sweden"], "indicator": "gdp" }Example response
{
"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 withYearandValue.
Notes
- At least one of
ticker,countryorindicatoris required. Forecastscan be empty for indicators with a yearly frequency; useYearEndForecastsinstead.
get_forecast_updates
Which indicator forecasts were updated, and when.
Returns the indicator forecasts that were recently updated, without the forecast values.
| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
country | string | No | — | Country name | For example "albania". |
startDate | string | No | — | YYYY-MM-DD | Returns the updates on or after this date. |
Example
“Which forecasts were updated since October 1, 2026?”
{ "startDate": "2026-10-01" }Example response
{
"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
countryorstartDate. Without either, all recent updates are returned. - To retrieve the forecast values, pass
Tickertoget_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.
| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
category | string (enum) | No | index | index, currency, commodity, crypto, bond | The market category. |
symbols | string | No | — | Market symbols, comma-separated | For example "DAX:IND" or "AAPL:US,DAX:IND". Takes priority over category. |
Example
“What are the price forecasts for commodities?”
{ "category": "commodity" }Example response
{
"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
symbolsis provided,categoryis ignored. Without either, the forecasts for stock indices are returned.