# Market Tools

> Current prices, price history and reference data for stocks, stock indices, currencies, commodities, government bonds and cryptocurrencies.

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

**Market symbols** use the format `{ticker}:{exchange or type}`, for example `"aapl:us"`, `"spx:ind"` or `"eurusd:cur"`. Use [`search`](https://docs.tradingeconomics.com/mcp/tools/search-news/#search), [`get_market_search`](#get_market_search) or [`get_market_symbology`](#get_market_symbology) to find them.

## Market snapshot fields

The snapshot tools return one row per instrument with these fields:

| Field | Description |
|---|---|
| `Symbol`, `Ticker`, `Name`, `Country` | The instrument identifiers, its name and its country. |
| `Type` or `Group` | The instrument type, for example `"stocks"`, `"index"` or `"commodity"`, or the market group, for example `"America G20 Major"`. |
| `State` or `state` | The market state, `"OPEN"` or `"CLOSED"`. |
| `Last`, `Date` | The latest price (the yield, for bonds) and its timestamp. |
| `Close`, `CloseDate` | The latest closing price and its date. |
| `DailyChange`, `WeeklyChange`, `MonthlyChange`, `YearlyChange`, `YTDChange` | The change over each period. |
| `DailyPercentualChange`, `WeeklyPercentualChange`, `MonthlyPercentualChange`, `YearlyPercentualChange`, `YTDPercentualChange` | The same changes, in percent. |
| `day_high`, `day_low` | The range of the current trading day. |
| `yesterday`, `lastWeek`, `lastMonth`, `lastYear`, `startYear` | The reference prices for those changes. |
| `allTimeHigh`, `allTimeHighDate`, `allTimeLow`, `allTimeLowDate` | The all-time high and low, with their dates. |
| `MarketCap`, `ISIN` | The market capitalization and the ISIN; `null` or empty when not applicable. |
| `unit`, `decimals`, `frequency` | The price unit, the number of decimals, and the update frequency, for example `"Live"`, `"Delayed"` or `"Daily"`. |
| `URL`, `Importance`, `StartDate`, `LastUpdate` | The path of the instrument page on the Trading Economics website, a ranking value, the first date of the price history, and the time of the last update. |

The field set varies slightly by tool:

- [`get_stock_indices`](#get_stock_indices), [`get_currencies`](#get_currencies), [`get_crypto`](#get_crypto), [`get_bonds`](#get_bonds) and [`get_market_stocks_by_country`](#get_market_stocks_by_country) in `snapshot` mode return `Group`, `State` and `StartDate`.
- [`get_commodities`](#get_commodities), [`get_market_symbol`](#get_market_symbol), [`get_market_search`](#get_market_search) and [`search`](https://docs.tradingeconomics.com/mcp/tools/search-news/#search) return `Type`, `state`, `MarketCap` and `ISIN`.
- [`get_market_peers`](#get_market_peers) and [`get_market_components`](#get_market_components) also return `relationship`, and do not return the all-time high and low.

## `get_stock_indices`

Snapshot of stock market indices worldwide.

Returns current data for the stock market indices covered by Trading Economics, such as the S&P 500, NASDAQ, Dow Jones, DAX and Nikkei 225.

This tool takes no parameters.

**Example**

*"How are the world's stock markets performing today?"*

```json
{}
```

### Example response

```json
{
  "columns": ["Symbol", "Ticker", "Name", "Country", "Date", "State", "Last", "Close", "CloseDate", "Group", "URL", "Importance", "DailyChange", "DailyPercentualChange", "WeeklyChange", "WeeklyPercentualChange", "MonthlyChange", "MonthlyPercentualChange", "YearlyChange", "YearlyPercentualChange", "YTDChange", "YTDPercentualChange", "day_high", "day_low", "yesterday", "lastWeek", "lastMonth", "lastYear", "startYear", "allTimeHigh", "allTimeHighDate", "allTimeLow", "allTimeLowDate", "decimals", "unit", "frequency", "StartDate", "LastUpdate"],
  "rows": [
    ["SPX:IND", "SPX", "US Index 500", "United States", "2026-10-26T14:25:48.117", "OPEN", 7677.03, 7677.03, "2026-10-26T14:26:00", "America G20 Major", "/united-states/stock-market", 1, 53.3494, 0.7, -13.696, -0.1781, -6.6626, -0.0867, 801.8731, 11.6633, 831.53, 12.1471, 7684.74, 7639.7, 7623.6806, 7690.726, 7683.6926, 6875.1569, 6845.5, 7844.67, "2026-10-06T15:26:00", 4.4, "1932-06-01T00:00:00", 2, "Index Points", "Live", "1928-01-03T00:00:00", "2026-10-26T14:26:00"],
    ["INDU:IND", "INDU", "US Index 30", "United States", "2026-10-26T14:26:24.123", "OPEN", 52533.18, 52533.18, "2026-10-26T14:26:00", "America G20 Major", "/indu:ind", 2, 318.0192, 0.61, 567.1453, 1.0914, 1051.6676, 2.0428, 4988.592, 10.4924, 4469.8936, 9.3, 52643.82, 52320.45, 52215.1608, 51966.0347, 51481.5124, 47544.588, 48063.2864, 54744.33, "2026-08-05T00:00:00", 28.48, "1896-08-08T00:00:00", 0, "Index Points", "Live", "1896-05-26T00:00:00", "2026-10-26T14:26:00"]
  ]
}
```

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

**Returns**

The [market snapshot fields](#market-snapshot-fields) of every index, including its `Symbol`, for example `"SPX:IND"`.

**Notes**

- This tool has no country filter. To find the indices of one country, use [`get_market_search`](#get_market_search) with that country and the category `index`.
- Pass the `Symbol` of an index as the `index` of [`get_earnings`](https://docs.tradingeconomics.com/mcp/tools/financials/#get_earnings) or the `symbol` of [`get_market_components`](#get_market_components). Do not construct index symbols manually.

## `get_commodities`

Commodity prices.

Returns current commodity prices, such as gold, crude oil and silver, for all commodities or for the commodities that match a name.

| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
| `commodity` | string | No | — | Commodity name | For example `"gold"` or `"crude-oil"`. Returns the commodities that match this name. Omit for all commodities. |

**Example**

*"What is the price of gold?"*

```json
{ "commodity": "gold" }
```

### Example response

```json
{
  "columns": ["Symbol", "Ticker", "Name", "Country", "Date", "Type", "decimals", "state", "Last", "Close", "CloseDate", "MarketCap", "URL", "Importance", "DailyChange", "DailyPercentualChange", "WeeklyChange", "WeeklyPercentualChange", "MonthlyChange", "MonthlyPercentualChange", "YearlyChange", "YearlyPercentualChange", "YTDChange", "YTDPercentualChange", "day_high", "day_low", "yesterday", "lastWeek", "lastMonth", "lastYear", "startYear", "allTimeHigh", "allTimeHighDate", "allTimeLow", "allTimeLowDate", "ISIN", "unit", "frequency", "LastUpdate"],
  "rows": [
    ["XAUUSD:CUR", "GC1", "Gold", "commodity", "2026-10-26T14:26:09.367", "commodity", 2, "OPEN", 4008.29, 4008.29, "2026-10-26T14:26:00", null, "/commodity/gold", 6, 14.33, 0.36, -132.61, -3.2024, -106.69, -2.5927, 26.76, 0.6721, -311.53, -7.2116, 4025.49, 3978.24, 3993.96, 4140.9, 4114.98, 3981.53, 4319.82, 5608.35, "2026-01-29T00:00:00", 34.83, "1970-02-03T00:00:00", "", "USD/t.oz", "Live", "2026-10-26T14:26:00"]
  ]
}
```

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

**Returns**

The [market snapshot fields](#market-snapshot-fields) of each commodity. `Country` is `"commodity"`.

**Notes**

- Current prices only. For historical prices, use [`get_market_historical`](#get_market_historical) with the commodity's symbol.

## `get_currencies`

Exchange rates.

Returns current exchange rates for all currency pairs, or for all the pairs of one currency.

| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
| `cross` | string | No | — | Currency code | For example `"EUR"` or `"USD"`. Returns all the pairs of this currency. |

**Example**

*"Show all the exchange rates of the euro."*

```json
{ "cross": "EUR" }
```

### Example response

```json
{
  "columns": ["Symbol", "Ticker", "Name", "Country", "Date", "State", "Last", "Close", "CloseDate", "Group", "URL", "Importance", "DailyChange", "DailyPercentualChange", "WeeklyChange", "WeeklyPercentualChange", "MonthlyChange", "MonthlyPercentualChange", "YearlyChange", "YearlyPercentualChange", "YTDChange", "YTDPercentualChange", "day_high", "day_low", "yesterday", "lastWeek", "lastMonth", "lastYear", "startYear", "allTimeHigh", "allTimeHighDate", "allTimeLow", "allTimeLowDate", "decimals", "unit", "frequency", "StartDate", "LastUpdate"],
  "rows": [
    ["EURUSD:CUR", "EUR", "EURUSD", "Euro Area", "2026-10-26T14:26:59.397", "CLOSED", 1.11843, 1.11843, "2026-10-26T14:27:00", "Europe G20 Major  EUR Cross", "/euro-area/currency", 1, -0.0018, -0.16, -0.0029, -0.256, -0.0187, -1.641, -0.046, -3.9537, -0.0556, -4.7383, 1.12267, 1.11736, 1.1202, 1.1213, 1.1371, 1.1645, 1.1741, 1.8686, "1973-07-06T00:00:00", 0.6444, "1985-02-26T00:00:00", 5, "", "Live", "1957-12-31T00:00:00", "2026-10-26T14:27:00"],
    ["EURGBP:CUR", "EURGBP", "EURGBP", "other", "2026-10-26T14:26:30.717", "CLOSED", 0.83828, 0.83828, "2026-10-26T14:27:00", "crosses  EUR Cross GBP Cross", "/eurgbp:cur", 253, 0.001, 0.11, -0.0044, -0.5174, -0.0196, -2.2858, -0.0349, -4.0002, -0.034, -3.8989, 0.84021, 0.83764, 0.8373, 0.8426, 0.8579, 0.8732, 0.8723, 0.9803, "2008-12-30T00:00:00", 0.5673, "2000-05-04T00:00:00", 5, "", "Live", "1986-05-07T00:00:00", "2026-10-26T14:27:00"]
  ]
}
```

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

**Returns**

The [market snapshot fields](#market-snapshot-fields) of each currency pair.

**Notes**

- For historical rates, use [`get_market_historical`](#get_market_historical) with the pair's symbol, for example `"eurusd:cur"`.
- The pairs of a currency include its cryptocurrency pairs, for example `"BTCEUR:CUR"`.

## `get_crypto`

Cryptocurrency prices.

Returns current prices for Bitcoin, Ethereum and the other cryptocurrencies covered by Trading Economics.

This tool takes no parameters.

**Example**

*"What are the current cryptocurrency prices?"*

```json
{}
```

### Example response

```json
{
  "columns": ["Symbol", "Ticker", "Name", "Country", "Date", "State", "Last", "Close", "CloseDate", "Group", "URL", "Importance", "DailyChange", "DailyPercentualChange", "WeeklyChange", "WeeklyPercentualChange", "MonthlyChange", "MonthlyPercentualChange", "YearlyChange", "YearlyPercentualChange", "YTDChange", "YTDPercentualChange", "day_high", "day_low", "yesterday", "lastWeek", "lastMonth", "lastYear", "startYear", "allTimeHigh", "allTimeHighDate", "allTimeLow", "allTimeLowDate", "decimals", "unit", "frequency", "StartDate", "LastUpdate"],
  "rows": [
    ["BTCUSD:CUR", "BTCUSD", "Bitcoin", "other", "2026-10-26T14:27:15.33", "OPEN", 79716.71, 79716.71, "2026-10-26T14:27:00", "crypto  stream", "/btcusd:cur", 201, -299.7, -0.37, -2142.54, -2.6173, -4744.17, -5.617, -34388.29, -30.1374, -7779.29, -8.891, 80439.64, 79305.05, 80016.41, 81859.25, 84460.88, 114105, 87496, 126267, "2025-10-06T18:58:00", 2.22, "2011-10-21T00:00:00", 0, "", "Live", "2011-08-18T00:00:00", "2026-10-26T14:27:00"],
    ["ETHUSD:CUR", "ETHUSD", "Ether", "other", "2026-10-26T14:27:04.75", "OPEN", 2308.66, 2308.66, "2026-10-26T14:27:00", "crypto  stream", "/ethusd:cur", 202, -17.755, -0.76, -96.121, -3.9971, -380.33, -14.144, -1810.0973, -43.9477, -658.46, -22.1919, 2334.5483, 2291.3008, 2326.415, 2404.781, 2688.99, 4118.7573, 2967.12, 4955.3, "2025-08-24T19:12:00", 80.9, "2018-12-14T00:00:00", 2, "", "Live", "2017-05-23T00:00:00", "2026-10-26T14:27:00"]
  ]
}
```

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

**Returns**

The [market snapshot fields](#market-snapshot-fields) of each cryptocurrency, priced in US dollars.

**Notes**

- For historical prices, use [`get_market_historical`](#get_market_historical) with the cryptocurrency's symbol.

## `get_bonds`

Government bond yields.

Returns government bond yields for all countries, for one country, or for one maturity.

| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
| `country` | string | No | — | Country name | For example `"france"` or `"united states"`. |
| `type` | string (enum) | No | — | `1M`, `3M`, `6M`, `52W`, `2Y`, `3Y`, `5Y`, `7Y`, `10Y`, `15Y`, `20Y`, `30Y` | The bond maturity. |

**Example**

*"Compare 10-year government bond yields across countries."*

```json
{ "type": "10Y" }
```

### Example response

```json
{
  "columns": ["Symbol", "Ticker", "Name", "Country", "Date", "State", "Last", "Close", "CloseDate", "Group", "URL", "Importance", "DailyChange", "DailyPercentualChange", "WeeklyChange", "WeeklyPercentualChange", "MonthlyChange", "MonthlyPercentualChange", "YearlyChange", "YearlyPercentualChange", "YTDChange", "YTDPercentualChange", "day_high", "day_low", "yesterday", "lastWeek", "lastMonth", "lastYear", "startYear", "allTimeHigh", "allTimeHighDate", "allTimeLow", "allTimeLowDate", "decimals", "unit", "frequency", "StartDate", "LastUpdate"],
  "rows": [
    ["USGG10YR:IND", "USGG10YR", "US 10Y", "United States", "2026-10-26T14:26:14", "OPEN", 4.967, 4.967, "2026-10-26T14:26:00", "America G20 Major  10Y", "/united-states/government-bond-yield", 100, -0.034, -0.034, -0.172, -0.172, -0.277, -0.277, 0.988, 0.988, 0.795, 0.795, 5.013, 4.965, 5.001, 5.139, 5.244, 3.979, 4.172, 15.82, "1981-09-30T00:00:00", 0.318, "2020-03-09T00:00:00", 4, "percent", "Delayed", "1912-06-01T00:00:00", "2026-10-26T14:27:00"],
    ["GUKG10:IND", "GUKG10", "UK 10Y", "United Kingdom", "2026-10-26T14:27:04", "OPEN", 5.3086, 5.3086, "2026-10-26T14:27:00", "Europe G20 Major  10Y", "/united-kingdom/government-bond-yield", 200, -0.0607, -0.0607, -0.136, -0.136, -0.092, -0.092, 0.9039, 0.9039, 0.8302, 0.8302, 5.3631, 5.3081, 5.3693, 5.4446, 5.4006, 4.4047, 4.4784, 16.09, "1981-11-02T00:00:00", 0.065, "2020-08-04T00:00:00", 4, "percent", "Delayed", "1980-01-01T00:00:00", "2026-10-26T14:27:00"]
  ]
}
```

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

**Returns**

The [market snapshot fields](#market-snapshot-fields) of each bond. `Last` is the yield, in percent.

**Notes**

- Provide at most one of `country` or `type`. Without either, the bonds of all countries are returned.

## `get_market_symbol`

Current snapshot of specific instruments.

Returns the current market data for one or more stocks, indices, commodities or currencies.

| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
| `symbols` | string | Yes | — | Market symbols, comma-separated | For example `"aapl:us"` or `"aapl:us,msft:us,eurusd:cur"`. |

**Example**

*"What are Apple's and Microsoft's share prices, and the EUR/USD exchange rate?"*

```json
{ "symbols": "aapl:us,msft:us,eurusd:cur" }
```

### Example response

```json
{
  "columns": ["Symbol", "Ticker", "Name", "Country", "Date", "Type", "decimals", "state", "Last", "Close", "CloseDate", "MarketCap", "URL", "Importance", "DailyChange", "DailyPercentualChange", "WeeklyChange", "WeeklyPercentualChange", "MonthlyChange", "MonthlyPercentualChange", "YearlyChange", "YearlyPercentualChange", "YTDChange", "YTDPercentualChange", "day_high", "day_low", "yesterday", "lastWeek", "lastMonth", "lastYear", "startYear", "allTimeHigh", "allTimeHighDate", "allTimeLow", "allTimeLowDate", "ISIN", "unit", "frequency", "LastUpdate"],
  "rows": [
    ["AAPL:US", "AAPL", "Apple", "United States", "2026-10-26T14:27:01.437", "stocks", 2, "OPEN", 345.24, 345.24, "2026-10-26T14:27:00", 4897205100000, "/aapl:us", 500, -2.49, -0.72, 2.3, 0.6707, 6.84, 2.0213, 76.43, 28.4327, 73.38, 26.9918, 345.67999, 341.05, 347.73, 342.94, 338.4, 268.81, 271.86, 351.73001, "2026-10-23T00:00:00", 0.11385, "1997-12-30T00:00:00", "US0378331005", "USD", "Live", "2026-10-26T14:27:00"],
    ["EURUSD:CUR", "EUR", "EURUSD", "Euro Area", "2026-10-26T14:26:59.397", "currency", 5, "CLOSED", 1.11843, 1.11843, "2026-10-26T14:27:00", null, "/euro-area/currency", 1, -0.0018, -0.16, -0.0029, -0.256, -0.0187, -1.641, -0.046, -3.9537, -0.0556, -4.7383, 1.12267, 1.11736, 1.1202, 1.1213, 1.1371, 1.1645, 1.1741, 1.8686, "1973-07-06T00:00:00", 0.6444, "1985-02-26T00:00:00", "", "", "Live", "2026-10-26T14:27:00"]
  ]
}
```

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

**Returns**

The [market snapshot fields](#market-snapshot-fields) of each symbol, including `Last`, `DailyChange`, `DailyPercentualChange`, `MarketCap`, `ISIN`, `Type`, `state` and `LastUpdate`.

**Notes**

- If a symbol is not known, resolve it first with [`get_market_search`](#get_market_search) or [`get_market_symbology`](#get_market_symbology).

## `get_market_historical`

Daily price history.

Returns daily open, high, low and close (OHLC) prices for one or more instruments.

| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
| `symbols` | string | Yes | — | Market symbols, comma-separated | For example `"aapl:us"` or `"aapl:us,msft:us"`. |
| `startDate` | string | No | — | `YYYY-MM-DD` | Start of the range. |
| `endDate` | string | No | — | `YYYY-MM-DD` | End of the range. Requires `startDate`. |

**Example**

*"Show Apple's and Microsoft's daily prices in 2025."*

```json
{ "symbols": "aapl:us,msft:us", "startDate": "2025-01-01", "endDate": "2025-12-31" }
```

### Example response

```json
{
  "columns": ["Symbol", "Date", "Open", "High", "Low", "Close"],
  "rows": [
    ["AAPL:US", "31/12/2025", 273.06, 273.67999, 271.75, 271.85999],
    ["MSFT:US", "31/12/2025", 487.84, 488.14001, 483.29999, 483.62]
  ]
}
```

*Retrieved on October 26, 2026; truncated to 2 of 502 rows.*

**Returns**

`Symbol`, `Date`, `Open`, `High`, `Low` and `Close` for each symbol and trading day, most recent first.

**Notes**

- The `Date` field of the response uses the format `dd/MM/yyyy`, unlike the `YYYY-MM-DD` dates of the request.
- For prices within the trading day, use [`get_market_intraday`](#get_market_intraday).

## `get_market_intraday`

Intraday price data.

Returns open, high, low and close prices at sub-daily intervals for up to five instruments.

| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
| `symbols` | string | Yes | — | Market symbols, comma-separated; at most 5 | For example `"aapl:us"`. |
| `interval` | string (enum) | No | `1h` | `1m`, `5m`, `10m`, `15m`, `30m`, `1h`, `2h`, `4h` | The interval of each price bar. |
| `startDate` | string | No | — | `YYYY-MM-DD` or `YYYY-MM-DD HH:mm` (24-hour, UTC) | Start of the range. A date without a time means 00:00. |
| `endDate` | string | No | — | `YYYY-MM-DD` or `YYYY-MM-DD HH:mm` (24-hour, UTC) | End of the range. Requires `startDate` and must not be earlier than it. |

**Example**

*"Show Apple's 15-minute prices on October 20, 2026, from 13:30 to 20:00 UTC."*

```json
{ "symbols": "aapl:us", "interval": "15m", "startDate": "2026-10-20 13:30", "endDate": "2026-10-20 20:00" }
```

### Example response

```json
{
  "columns": ["Symbol", "Date", "Open", "High", "Low", "Close"],
  "rows": [
    ["AAPL:US", "2026-10-20T20:00:00", 339.39, 339.63, 339.2, 339.35],
    ["AAPL:US", "2026-10-20T19:45:00", 339.35, 339.49, 339.01, 339.4]
  ]
}
```

*Retrieved on October 26, 2026; truncated to 2 of 26 rows.*

**Returns**

`Symbol`, `Date` (`YYYY-MM-DDTHH:mm:ss`), `Open`, `High`, `Low` and `Close` for each interval, most recent first.

**Notes**

- Intraday data covers only the last 30 days. A `startDate` earlier than that returns no data.

## `get_market_search`

Search market instruments.

Searches stocks, indices, bonds, commodities and currencies by country or by search term, optionally restricted to one or more categories.

| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
| `country` | string | Conditional | — | Full country name | For example `"united states"`. |
| `term` | string | Conditional | — | Search term | For example `"msft"` or `"apple"`. |
| `category` | string | No | — | One or more of `index`, `markets`, `forex`, `bond`, `commodity`, comma-separated, in lowercase | For example `"index"` or `"index,markets"`. Omit to search all categories. |

**Example**

*"Which stock indices are there in Portugal?"*

```json
{ "country": "portugal", "category": "index" }
```

### Example response

```json
{
  "columns": ["Symbol", "Ticker", "Name", "Country", "Date", "Type", "decimals", "state", "Last", "Close", "CloseDate", "MarketCap", "URL", "Importance", "DailyChange", "DailyPercentualChange", "WeeklyChange", "WeeklyPercentualChange", "MonthlyChange", "MonthlyPercentualChange", "YearlyChange", "YearlyPercentualChange", "YTDChange", "YTDPercentualChange", "day_high", "day_low", "yesterday", "lastWeek", "lastMonth", "lastYear", "startYear", "allTimeHigh", "allTimeHighDate", "allTimeLow", "allTimeLowDate", "ISIN", "unit", "frequency", "LastUpdate"],
  "rows": [
    ["BVLX:IND", "BVLX", "PSI Geral", "Portugal", "2026-10-26T14:13:00", "index", 0, "OPEN", 6227.09, 6227.09, "2026-10-26T14:13:00", 80471461050, "/bvlx:ind", 490, -50.4398, -0.8, -160.8099, -2.5174, -351.9798, -5.35, 703.78, 12.742, 859.0002, 16.002, 6298.1001, 6169.47998, 6277.5298, 6387.8999, 6579.0698, 5523.31, 5368.0898, 6612.53, "2026-09-30T10:57:00", 537.201, "1993-01-13T00:00:00", "", "Index Points", "Daily", "2026-10-26T14:28:00"],
    ["PSI20:IND", "PSI20", "PSI", "Portugal", "2026-10-26T14:28:00", "index", 0, "OPEN", 9186.15, 9186.15, "2026-10-26T14:28:00", 14289010201, "/portugal/stock-market", 491, -58.47, -0.63, -208.0329, -2.2145, -526.1998, -5.4178, 834.1426, 9.9873, 922.4991, 11.1633, 9226.83, 9119.21, 9244.62, 9394.1829, 9712.3498, 8352.0074, 8263.6509, 15080.99, "2000-03-09T00:00:00", 66.8246, "2024-08-26T00:00:00", "", "Index Points", "Delayed", "2026-10-26T14:28:00"]
  ]
}
```

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

**Returns**

The [market snapshot fields](#market-snapshot-fields) of each matching instrument.

**Notes**

- Exactly one of `country` or `term` is required.
- To search the whole catalog, including economic indicators, use [`search`](https://docs.tradingeconomics.com/mcp/tools/search-news/#search).

## `get_market_symbology`

Map symbols, tickers and ISINs.

Returns the cross-reference between identifier systems for market instruments: the Trading Economics symbol, the Bloomberg-style ticker and the ISIN.

| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
| `symbol` | string | Conditional | — | `{ticker}:{exchange}` | For example `"aapl:us"`. |
| `ticker` | string | Conditional | — | Bloomberg-style ticker | For example `"aapl"`. |
| `isin` | string | Conditional | — | ISIN code | For example `"US0378331005"`. |
| `country` | string | Conditional | — | Country name | For example `"mexico"`. Returns the instruments of this country. |

**Example**

*"Which instrument has the ISIN US0378331005?"*

```json
{ "isin": "US0378331005" }
```

### Example response

```json
{
  "columns": ["Symbol", "Ticker", "ISIN", "Name", "Country"],
  "rows": [
    ["AAPL:US", "AAPL", "US0378331005", "Apple", "United States"]
  ]
}
```

*Retrieved on October 26, 2026; complete response.*

**Returns**

`Symbol`, `Ticker`, `ISIN`, `Name`, `Country`.

**Notes**

- Exactly one of `symbol`, `ticker`, `isin` or `country` is required.

## `get_market_peers`

Comparable instruments.

Returns instruments comparable to a given market symbol, such as stocks, indices or commodities traded in the same category.

| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
| `symbol` | string | Yes | — | `{ticker}:{exchange}` | For example `"aapl:us"`. |

**Example**

*"Which stocks are comparable to Apple?"*

```json
{ "symbol": "aapl:us" }
```

### Example response

```json
{
  "columns": ["Symbol", "relationship", "Ticker", "Name", "Country", "Date", "Type", "decimals", "state", "Last", "Close", "CloseDate", "MarketCap", "URL", "Importance", "DailyChange", "DailyPercentualChange", "WeeklyChange", "WeeklyPercentualChange", "MonthlyChange", "MonthlyPercentualChange", "YearlyChange", "YearlyPercentualChange", "YTDChange", "YTDPercentualChange", "day_high", "day_low", "yesterday", "lastWeek", "lastMonth", "lastYear", "startYear", "ISIN", "unit", "frequency", "StartDate", "LastUpdate"],
  "rows": [
    ["MSFT:US", 1, "MSFT", "Microsoft", "United States", "2026-10-26T14:27:44.007", "stocks", 2, "OPEN", 527.04, 527.04, "2026-10-26T14:28:00", 2902705700000, "/msft:us", 502, 2.53, 0.48, -6.48, -1.2146, 17.82, 3.4995, -4.48, -0.8429, 43.42, 8.9781, 528.96002, 521.87, 524.51, 533.52, 509.22, 531.52, 483.62, "US5949181045", "USD", "Live", "1993-09-02T00:00:00", "2026-10-26T14:28:00"],
    ["SPX:IND", 0, "SPX", "US Index 500", "United States", "2026-10-26T14:27:50.15", "index", 2, "OPEN", 7672.8, 7672.8, "2026-10-26T14:28:00", 65930770424563, "/united-states/stock-market", 1, 49.1194, 0.64, -17.926, -0.2331, -10.8926, -0.1418, 797.6431, 11.6018, 827.3, 12.0853, 7684.74, 7639.7, 7623.6806, 7690.726, 7683.6926, 6875.1569, 6845.5, "", "Index Points", "Live", "1928-01-03T00:00:00", "2026-10-26T14:28:00"]
  ]
}
```

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

**Returns**

The [market snapshot fields](#market-snapshot-fields) of each peer instrument, plus `relationship`.

**Notes**

- To find a symbol, use [`get_market_search`](#get_market_search) or [`search`](https://docs.tradingeconomics.com/mcp/tools/search-news/#search).
- The list can include stocks from other countries, related stock indices and the requested symbol itself.

## `get_market_components`

Constituents of stock indices.

Returns the member stocks of one or more stock indices, with their current price data.

| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
| `symbol` | string | Yes | — | Index symbols, comma-separated | For example `"psi20:ind"` or `"psi20:ind,spx:ind"`. |

**Example**

*"Which companies are in the PSI index?"*

```json
{ "symbol": "psi20:ind" }
```

### Example response

```json
{
  "columns": ["Symbol", "relationship", "Ticker", "Name", "Country", "Date", "Type", "decimals", "state", "Last", "Close", "CloseDate", "MarketCap", "URL", "Importance", "DailyChange", "DailyPercentualChange", "WeeklyChange", "WeeklyPercentualChange", "MonthlyChange", "MonthlyPercentualChange", "YearlyChange", "YearlyPercentualChange", "YTDChange", "YTDPercentualChange", "day_high", "day_low", "yesterday", "lastWeek", "lastMonth", "lastYear", "startYear", "ISIN", "unit", "frequency", "StartDate", "LastUpdate"],
  "rows": [
    ["ALTR:PL", 0, "ALSS", "Altri", "Portugal", "2026-10-26T14:22:02", "stocks", 2, "CLOSED", 4.3, 4.3, "2026-10-26T14:22:00", 963093200, "/altr:pl", 1000, 0.025, 0.58, -0.055, -1.2629, -0.425, -8.9947, -0.71, -14.1717, -0.2, -4.4444, 4.32, 4.275, 4.275, 4.355, 4.725, 5.01, 4.5, "PTALT0AE0002", "EUR", "Daily", "2000-06-01T00:00:00", "2026-10-26T14:22:00"],
    ["BCP:PL", 0, "BCP", "BCP", "Portugal", "2026-10-26T14:27:11", "stocks", 2, "CLOSED", 1.0765, 1.0765, "2026-10-26T14:27:00", 16277767178, "/bcp:pl", 1000, 0.017, 1.6, -0.0295, -2.6673, -0.133, -10.9963, 0.3051, 39.5515, 0.1803, 20.1183, 1.082, 1.065, 1.0595, 1.106, 1.2095, 0.7714, 0.8962, "PTBCP0AM0007", "EUR", "Daily", "1993-10-14T00:00:00", "2026-10-26T14:27:00"]
  ]
}
```

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

**Returns**

The [market snapshot fields](#market-snapshot-fields) of each member of the index, plus `relationship`.

**Notes**

- Use [`get_stock_indices`](#get_stock_indices) to find index symbols.

## `get_market_stocks_by_country`

Stocks listed in one or more countries.

Lists the stocks listed in one or more countries, either with current prices or as a lightweight list.

| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
| `country` | string | Yes | — | Country names, comma-separated | For example `"portugal"` or `"united states,nigeria"`. |
| `mode` | string (enum) | No | `snapshot` | `snapshot`, `list` | `snapshot`: current market data for each stock. `list`: lightweight metadata only, smaller and faster. |

**Example**

*"Which stocks are listed in Portugal?"*

```json
{ "country": "portugal", "mode": "list" }
```

### Example response

```json
{
  "columns": ["Symbol", "Name", "Country", "Type", "URL", "Frequency", "Unit"],
  "rows": [
    ["ALTR:PL", "Altri", "Portugal", "stocks", "/altr:pl", "Daily", "EUR"],
    ["BCP:PL", "BCP", "Portugal", "stocks", "/bcp:pl", "Daily", "EUR"]
  ]
}
```

*Retrieved on October 26, 2026; truncated to 2 of 41 rows.*

**Returns**

- `snapshot`: the [market snapshot fields](#market-snapshot-fields) of each stock, including `Last`, `DailyChange`, `DailyPercentualChange`, `State` and `LastUpdate`.
- `list`: `Symbol`, `Name`, `Country`, `Type`, `URL`, `Frequency`, `Unit`.

**Notes**

- Neither mode returns the market capitalization; use [`get_market_symbol`](#get_market_symbol) for it.
- The `snapshot` mode returns stocks only. The `list` mode can also include the country's stock indices and government bonds; check `Type`.
- Pass the `Symbol` of a stock to [`get_market_symbol`](#get_market_symbol), [`get_market_historical`](#get_market_historical) or [`get_stock_description`](#get_stock_description).

## `get_stock_description`

Company profiles.

Returns company profile data: sector, industry, sub-industry and business description. Query specific stocks by symbol, or every company listed in a country.

| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
| `symbol` | string | Conditional | — | Stock symbols, comma-separated | For example `"aapl:us"` or `"aapl:us,msft:us"`. |
| `country` | string | Conditional | — | Country name | For example `"france"`. Returns every company listed in this country. |

**Example**

*"What do Apple and Microsoft do?"*

```json
{ "symbol": "aapl:us,msft:us" }
```

### Example response

```json
{
  "columns": ["Symbol", "Name", "Description", "Country", "Sector", "Industry", "Subindustry"],
  "rows": [
    ["AAPL:US", "Apple Inc", "Apple Inc. designs, manufactures and markets smartphones, personal computers, tablets, wearables and accessories, and sells a variety of related services. ...", "United States", "Information Technology", "Technology Hardware & Equipment", "Technology Hardware, Storage & Peripherals"],
    ["MSFT:US", "Microsoft", "Microsoft Corporation is a technology company. The Company develops and supports software, services, devices, and solutions. ...", "United States", "Information Technology", "Software & Services", "Systems Software"]
  ]
}
```

*Retrieved on October 26, 2026; complete response, with `Description` shortened.*

**Returns**

`Symbol`, `Name`, `Description`, `Country`, `Sector`, `Industry` and `Subindustry` for each company.

**Notes**

- Exactly one of `symbol` or `country` is required.

## `get_market_discontinued`

Discontinued market symbols.

Returns market instruments that have been discontinued, such as delisted stocks and merged entities.

This tool takes no parameters.

**Example**

*"Which market symbols have been discontinued?"*

```json
{}
```

### Example response

```json
{
  "columns": ["Symbol", "Ticker", "Name", "Country", "Category", "Reason"],
  "rows": [
    ["11:HK", "0011", "Hang Seng Bank", "Hong Kong", "stocks", "Merged"],
    ["600190:CH", "600190", "Jinzhou Port", "China", "stocks", "Delisted"]
  ]
}
```

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

**Returns**

`Symbol`, `Ticker`, `Name`, `Country`, `Category`, `Reason`. `Reason` is, for example, `"Merged"`, `"Delisted"`, `"Acquired"`, `"Suspended"` or `"Stopped"`.

**Notes**

- The list covers all countries.

