# Economic Indicator Tools

> Latest values, historical time series, related series, and the updates and revisions of economic indicators.

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

## `get_indicator_data`

Latest values of economic indicators.

Returns the latest snapshot of economic indicators in one of three modes, selected by the parameters provided:

- **Ticker mode:** one series, by its Trading Economics ticker.
- **All-countries mode:** one or more indicators across every country (`indicator` without `country`).
- **Country mode:** one or more countries, optionally narrowed to specific indicators (`indicator`) or to one category group (`group`). Without a filter, every indicator of those countries is returned, which produces a large response.

| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
| `ticker` | string | Conditional | — | Trading Economics ticker, for example `"USURTOT"` | One series. Takes priority over `country` and `indicator`. Use the `HistoricalDataSymbol` field of a previous result. |
| `country` | string or string[] | Conditional | — | Country names | One or more countries, for example `"united states"` or `["united states", "portugal"]`. |
| `indicator` | string or string[] | Conditional | — | Indicator names | One or more indicators, for example `"gdp"` or `["gdp", "inflation rate"]`. |
| `group` | string (enum) | No | — | `gdp`, `labour`, `prices`, `money`, `trade`, `government`, `business`, `consumer`, `housing`, `taxes`, `health`, `climate`, `markets` | One category group, in lowercase. |

**Examples**

*"What is the current inflation rate in the United States?"*

```json
{ "country": "united states", "indicator": "inflation rate" }
```

### Example response

```json
{
  "columns": ["Country", "Category", "Title", "LatestValueDate", "LatestValue", "Source", "SourceURL", "Unit", "URL", "CategoryGroup", "Adjustment", "Frequency", "HistoricalDataSymbol", "CreateDate", "FirstValueDate", "PreviousValue", "PreviousValueDate", "HighestValue", "HighestValueDate", "LowestValue", "LowestValueDate"],
  "rows": [
    ["United States", "Inflation Rate", "United States Inflation Rate", "2026-09-30T00:00:00", 3.7, "U.S. Bureau of Labor Statistics", "http://www.bls.gov/", "percent", "/united-states/inflation-cpi", "Prices", "NSA", "Monthly", "CPI YOY", "2011-06-27T00:00:00", "1914-12-31T00:00:00", 3.4, "2026-08-31T00:00:00", 23.7, "1920-06-30T00:00:00", -15.8, "1921-06-30T00:00:00"]
  ]
}
```

*Retrieved on October 26, 2026; complete response. Values change over time.*

*"Give me a labor market snapshot for Canada."*

```json
{ "country": "canada", "group": "labour" }
```

### Example response

```json
{
  "columns": ["Country", "Category", "Title", "LatestValueDate", "LatestValue", "Source", "SourceURL", "Unit", "URL", "CategoryGroup", "Adjustment", "Frequency", "HistoricalDataSymbol", "CreateDate", "FirstValueDate", "PreviousValue", "PreviousValueDate", "HighestValue", "HighestValueDate", "LowestValue", "LowestValueDate"],
  "rows": [
    ["Canada", "Employment Change", "Canada Employment Change", "2026-09-30T00:00:00", -68.3, "Statistics Canada", "https://www.statcan.gc.ca", "Thousand", "/canada/employment-change", "Labour", "Volume, SA", "Monthly", "CANADAEMPCHA", "2014-03-07T14:04:00", "1976-02-29T00:00:00", -41.7, "2026-08-31T00:00:00", 1035.8, "2020-06-30T00:00:00", -1991.4, "2020-04-30T00:00:00"],
    ["Canada", "Unemployment Rate", "Canada Unemployment Rate", "2026-09-30T00:00:00", 6.5, "Statistics Canada", "http://www.statcan.gc.ca", "percent", "/canada/unemployment-rate", "Labour", "SA", "Monthly", "CANLXEMR", "2012-11-21T12:03:00", "1966-01-31T00:00:00", 6.4, "2026-08-31T00:00:00", 14.2, "2020-05-31T00:00:00", 2.9, "1966-06-30T00:00:00"]
  ]
}
```

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

**Returns**

`Country`, `Category`, `Title`, `LatestValue`, `LatestValueDate`, `PreviousValue`, `PreviousValueDate`, `Unit`, `Frequency`, `HistoricalDataSymbol`, `Source`, `SourceURL`, `URL`, `CategoryGroup`, `Adjustment`, `CreateDate`, `FirstValueDate`, `HighestValue`, `HighestValueDate`, `LowestValue`, `LowestValueDate`.

**Notes**

- At least one of `ticker`, `country` or `indicator` is required.
- When `ticker` is provided, `country` and `indicator` are ignored.
- `group` requires `country` and cannot be combined with `ticker` or `indicator`. The group appears in the `CategoryGroup` field of the results, for example `"Labour"`.
- Pass `HistoricalDataSymbol` as the `ticker` of [`get_historical_data`](#get_historical_data) to retrieve the history of a series.

## `get_historical_data`

Historical time series of economic indicators.

Returns the history of one series by ticker, or of one or more indicators for one or more countries.

| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
| `ticker` | string | Conditional | — | Trading Economics ticker, for example `"USURTOT"` | One series. Takes priority over `country` and `indicator`. |
| `country` | string or string[] | Conditional | — | Country names | One or more countries. |
| `indicator` | string or string[] | Conditional | — | Indicator names | One or more indicators. Required with `country`. |
| `startDate` | string | No | — | `YYYY-MM-DD` | Returns data from this date. |
| `endDate` | string | No | — | `YYYY-MM-DD` | Returns data up to this date. Requires `startDate`. Applies only with `country` and `indicator`. |

**Examples**

*"Show inflation in Portugal, Spain and Greece from 2015 to 2023."*

```json
{
  "country": ["portugal", "spain", "greece"],
  "indicator": "inflation rate",
  "startDate": "2015-01-01",
  "endDate": "2023-12-31"
}
```

### Example response

```json
{
  "columns": ["Country", "Category", "DateTime", "Value", "Frequency", "HistoricalDataSymbol", "LastUpdate"],
  "rows": [
    ["Greece", "Inflation Rate", "2015-01-31T00:00:00", -2.8, "Monthly", "GKCPNEWY", "2015-02-17T10:12:00"],
    ["Portugal", "Inflation Rate", "2015-01-31T00:00:00", -0.39, "Monthly", "PLCPYOY", "2026-07-10T10:13:00"]
  ]
}
```

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

*"Show the US unemployment rate series since 2010."*

```json
{ "ticker": "USURTOT", "startDate": "2010-01-01" }
```

### Example response

```json
{
  "columns": ["Country", "Category", "DateTime", "Value", "Frequency", "HistoricalDataSymbol", "LastUpdate"],
  "rows": [
    ["United States", "Unemployment Rate", "2010-01-31T00:00:00", 9.8, "Monthly", "USURTOT", "2017-04-07T13:29:00"],
    ["United States", "Unemployment Rate", "2010-02-28T00:00:00", 9.8, "Monthly", "USURTOT", "2012-02-23T11:41:00"]
  ]
}
```

*Retrieved on October 26, 2026; truncated to the first 2 rows. Values change over time.*

**Returns**

`Country`, `Category`, `DateTime`, `Value`, `Frequency`, `HistoricalDataSymbol`, `LastUpdate`.

**Notes**

- Provide either `ticker`, or `country` together with `indicator`.
- With `ticker` and no `startDate`, only a recent window of the series is returned, not its full history. Add `startDate` to retrieve the history from that date. `endDate` has no effect with `ticker`.
- Long country lists are split automatically into requests of up to 10 countries, and each request counts toward your API usage.
- Each request returns up to 10,000 rows.

## `get_indicator_peers`

Series related to an indicator.

Returns the series related to a given indicator: related, component, parent, derivative and underlying series. Query by ticker, or by one country and one indicator category.

| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
| `ticker` | string | Conditional | — | Trading Economics ticker, for example `"CPI YOY"` | The series whose peers you want. Takes priority over `country` and `category`. |
| `country` | string | Conditional | — | One country name | For example `"portugal"`. Lists are not accepted. |
| `category` | string | Conditional | — | One indicator name | For example `"inflation rate"`. Lists are not accepted. |

**Example**

*"Which series are related to inflation in Portugal?"*

```json
{ "country": "portugal", "category": "inflation rate" }
```

### Example response

```json
{
  "columns": ["Ticker", "Peer", "Relationship", "Country", "Category", "Title", "LatestValueDate", "LatestValue", "Source", "SourceURL", "Unit", "URL", "CategoryGroup", "Adjustment", "Frequency", "HistoricalDataSymbol", "CreateDate", "FirstValueDate", "PreviousValue", "PreviousValueDate"],
  "rows": [
    ["PLCPYOY", "PORTUGALCORINFRAT", 0, "Portugal", "Core Inflation Rate", "Portugal Core Inflation Rate", "2026-09-30T00:00:00", 2.72, "Statistics Portugal", "http://www.ine.pt", "percent", "/portugal/core-inflation-rate", "Prices", "NSA", "Monthly", "PORTUGALCORINFRAT", "2014-08-12T11:26:00", "1949-01-31T00:00:00", 2.64, "2026-08-31T00:00:00"],
    ["PLCPYOY", "PRTENEINF", 1, "Portugal", "Energy Inflation", "Portugal Energy Inflation", "2026-09-30T00:00:00", 15.39, "Statistics Portugal", "http://www.ine.pt", "percent", "/portugal/energy-inflation", "Prices", "NSA", "Monthly", "PRTENEINF", "2026-07-10T10:25:00", "1949-01-31T00:00:00", 12.2, "2026-08-31T00:00:00"]
  ]
}
```

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

**Returns**

`Ticker`, `Peer`, `Relationship`, `Country`, `Category`, `Title`, `LatestValue`, `LatestValueDate`, `PreviousValue`, `PreviousValueDate`, `Unit`, `Frequency`, `HistoricalDataSymbol`, `Source`, `SourceURL`, `URL`, `CategoryGroup`, `Adjustment`, `CreateDate`, `FirstValueDate`.

**Notes**

- Provide either `ticker`, or both `country` and `category`.
- `Relationship` values: `0` = related, `1` = component, `2` = parent, `3` = derivative, `4` = underlying.

## `get_indicators_list`

Catalog of available indicators.

Returns the economic indicators available from Trading Economics, with their category group. Use it to discover valid indicator names.

| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
| `country` | string | No | — | One country name | Lists only the indicators available for this country. Lists are not accepted. |
| `calendar` | integer | No | — | `1`, `2` or `3` | Economic calendar filter. Use `1` to list only the indicators that appear in the economic calendar. |

**Example**

*"Which US indicators appear in the economic calendar?"*

```json
{ "country": "united states", "calendar": 1 }
```

### Example response

```json
{
  "columns": ["Category", "CategoryGroup"],
  "rows": [
    ["10 Year TIPS Yield", "Bonds"],
    ["15 Year Mortgage Rate", "Housing"]
  ]
}
```

*Retrieved on October 26, 2026; truncated to the first 2 rows. Values change over time.*

**Returns**

`Category` and `CategoryGroup` for each indicator.

**Notes**

- Without parameters, the complete catalog is returned. `country` and `calendar` can be combined.

## `get_indicator_updates`

Which indicator series were updated, and when.

Returns the latest updates, additions and revisions applied to economic indicator series, without their values. Filter by country, by date (optionally from a time of day), or by country and date.

| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
| `date` | string | No | — | `YYYY-MM-DD` | Returns the updates made on or after this date. |
| `time` | string | No | — | `HH:mm` (24-hour), for example `"15:20"` | Returns the updates made on or after this time of `date`. |
| `country` | string | No | — | Country name | Returns the updates for this country. |

**Example**

*"Which indicators were updated since 15:20 on October 20, 2026?"*

```json
{ "date": "2026-10-20", "time": "15:20" }
```

### Example response

```json
{
  "columns": ["Country", "Category", "HistoricalDataSymbol", "LastUpdate"],
  "rows": [
    ["Bosnia and Herzegovina", "Average Weekly Hours", "BIHAVGWEEKLYHOURS", "2026-10-26T14:24:15.873"],
    ["United States", "Banks Balance Sheet", "UNITEDSTABANBALSHE", "2026-10-26T14:20:45.903"]
  ]
}
```

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

**Returns**

`Country`, `Category`, `HistoricalDataSymbol`, `LastUpdate` (UTC).

**Notes**

- `time` requires `date` and cannot be combined with `country`.
- Without `country`, only the updates of the last two months are available.
- To retrieve the updated values, pass `HistoricalDataSymbol` as the `ticker` of [`get_historical_data`](#get_historical_data) or [`get_indicator_data`](#get_indicator_data).

## `get_historical_latest`

Recently updated or revised records, with their values.

Returns the historical records of economic indicators that were recently updated or revised. Optionally filter by country, by date, or both.

| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
| `country` | string | No | — | Country name | For example `"brazil"`. |
| `date` | string | No | — | `YYYY-MM-DD` | Returns only the records updated on this date. |

**Example**

*"Which Brazilian indicators were recently updated, and with what values?"*

```json
{ "country": "brazil" }
```

### Example response

```json
{
  "columns": ["Country", "Category", "DateTime", "Value", "Frequency", "HistoricalDataSymbol", "LastUpdate"],
  "rows": [
    ["Brazil", "Remittances", "2026-09-30T00:00:00", 335.9, "Monthly", "BrazilRem", "2026-10-26T13:01:00"],
    ["Brazil", "Current Account to GDP", "2025-12-31T00:00:00", -2.96, "Yearly", "BRACA2GDP", "2026-10-26T12:59:00"]
  ]
}
```

*Retrieved on October 26, 2026; truncated to the first 2 rows. Values change over time.*

**Returns**

`Country`, `Category`, `DateTime`, `Value`, `Frequency`, `HistoricalDataSymbol`, `LastUpdate`.

**Notes**

- For a lighter list without values, use [`get_historical_updates`](#get_historical_updates).

## `get_historical_updates`

Lightweight list of recently updated series.

Returns the indicator series that were recently updated, without their values.

This tool takes no parameters.

**Example**

*"Which indicator series were updated recently?"*

```json
{}
```

### Example response

```json
{
  "columns": ["Country", "Category", "HistoricalDataSymbol", "LastUpdate"],
  "rows": [
    ["Bosnia and Herzegovina", "Average Weekly Hours", "BIHAVGWEEKLYHOURS", "2026-10-26T14:24:00"],
    ["United States", "Banks Balance Sheet", "UNITEDSTABANBALSHE", "2026-10-26T14:20:00"]
  ]
}
```

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

**Returns**

`Country`, `Category`, `HistoricalDataSymbol`, `LastUpdate`.

**Notes**

- For the updated records with their values, use [`get_historical_latest`](#get_historical_latest).

## `get_indicator_changes`

Indicators whose data series changed, with the reason.

Returns economic indicators whose data series recently changed, together with the reason for each change.

| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
| `date` | string | No | — | `YYYY-MM-DD` | Returns the changes from this date. |

**Example**

*"Which indicator series have changed since September 1, 2026?"*

```json
{ "date": "2026-09-01" }
```

### Example response

```json
{
  "columns": ["Country", "Category", "Ticker", "Reason", "Date"],
  "rows": [
    ["Bolivia", "Foreign Exchange Reserves", "BOLIVIAFOREXCRES", "Replacement", "2026-10-16T08:43:36.67"],
    ["Poland", "Labor Force Participation Rate", "POLANDLFPR", "Other", "2026-10-14T04:02:56.783"]
  ]
}
```

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

**Returns**

`Country`, `Category`, `Ticker`, `Reason` and `Date` for each change. `Reason` is a short label, for example `"Base year"`, `"Frequency"`, `"Unit"`, `"Replacement"`, `"Discontinued"` or `"Other"`. `Ticker` can be empty.

**Notes**

- Without `date`, the most recent changes are returned.

## `get_discontinued_indicators`

Series no longer updated by their source.

Returns data series that have been discontinued, that is, series that the official source no longer updates.

| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
| `countries` | string or string[] | No | — | Country names | One or more countries, for example `"united states,china"`. Omit for all countries. |

**Example**

*"Which US and Chinese indicators have been discontinued?"*

```json
{ "countries": "united states,china" }
```

### Example response

```json
{
  "columns": ["Country", "Category", "Title", "LatestValueDate", "LatestValue", "Source", "SourceURL", "Unit", "URL", "CategoryGroup", "Adjustment", "Frequency", "HistoricalDataSymbol", "CreateDate", "FirstValueDate", "PreviousValue", "PreviousValueDate", "HighestValue", "HighestValueDate", "LowestValue", "LowestValueDate"],
  "rows": [
    ["China", "1 Year MLF Rate", "China One-Year Medium-Term Lending Facility Rate", "2025-02-25T00:00:00", 2, "People's Bank of China", "http://www.pbc.gov.cn/", "percent", "/china/1-year-mlf-rate", "Money", "", "Monthly", "CHN1YMR", "2023-02-15T15:22:00", "2016-01-19T00:00:00", 2, "2025-01-24T00:00:00", 3.3, "2018-04-17T00:00:00", 2, "2024-09-25T00:00:00"],
    ["China", "Competitiveness Index", "China Competitiveness Index", "2019-12-31T00:00:00", 73.9, "World Economic Forum", "https://www.weforum.org", "Points", "/china/competitiveness-index", "Business", "", "Yearly", "ChinaComInd", "2015-06-12T17:19:00", "2007-12-31T00:00:00", 72.61, "2018-12-31T00:00:00", 73.9, "2019-12-31T00:00:00", 4.55, "2007-12-31T00:00:00"]
  ]
}
```

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

**Returns**

The same fields as [`get_indicator_data`](#get_indicator_data), for each discontinued series. `LatestValueDate` is the date of the last observation.

**Notes**

- The parameter is named `countries` (plural), unlike the `country` parameter of the other indicator tools.
- Without `countries`, the discontinued series of all countries are returned.

