# Forecast Tools

> Trading Economics forecasts for economic indicators and market prices.

Source: https://docs.tradingeconomics.com/mcp/tools/forecasts/

## Forecast fields

[`get_forecast`](#get_forecast) and [`get_market_forecast`](#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:

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.

| 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?"*

```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](#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.

| 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?"*

```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_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?"*

```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](#forecast-fields).

**Notes**

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

