Trading Economics MCP Tools

The Trading Economics MCP server exposes 46 read-only tools that give AI applications structured access to Trading Economics data: economic indicators, the economic calendar, forecasts, market prices, company financials and corporate events, sovereign credit ratings, and news. The tools cover both live market data and historical time series.

The tools are served by the remote server at https://mcp.tradingeconomics.com. Requests are authenticated with your Trading Economics credentials, through an OAuth sign-in or your API key. To build agentic software, you can use the server with foundation models from providers such as OpenAI, Anthropic or Meta, and with any other MCP-compatible large language model or agent framework.

Tool index

Catalog search

Tool	Summary
`search`	Search the whole Trading Economics catalog by keyword.

Economic indicators

Tool	Summary
`get_indicator_data`	Latest values of economic indicators.
`get_historical_data`	Historical time series of economic indicators.
`get_indicator_peers`	Series related to an indicator.
`get_indicators_list`	Catalog of available indicators.
`get_indicator_updates`	Which indicator series were updated, and when.
`get_historical_latest`	Recently updated or revised records, with their values.
`get_historical_updates`	Lightweight list of recently updated series.
`get_indicator_changes`	Indicators whose data series changed, with the reason.
`get_discontinued_indicators`	Series no longer updated by their source.

Economic calendar

Tool	Summary
`get_calendar_by_country`	Calendar events, globally or for one country.
`get_calendar_by_indicator`	Calendar events for one or more indicators.
`get_calendar_by_group`	Calendar events for a thematic group.
`get_calendar_by_ticker`	Calendar events for one or more tickers.
`get_calendar_point_in_time`	Calendar events as originally published.

Forecasts

Tool	Summary
`get_forecast`	Forecasts for economic indicators.
`get_forecast_updates`	Which indicator forecasts were updated, and when.
`get_market_forecast`	Price forecasts for markets.

Markets

Tool	Summary
`get_stock_indices`	Snapshot of stock market indices worldwide.
`get_commodities`	Commodity prices.
`get_currencies`	Exchange rates.
`get_crypto`	Cryptocurrency prices.
`get_bonds`	Government bond yields.
`get_market_symbol`	Current snapshot of specific instruments.
`get_market_historical`	Daily price history.
`get_market_intraday`	Intraday price data.
`get_market_search`	Search market instruments.
`get_market_symbology`	Map symbols, tickers and ISINs.
`get_market_peers`	Comparable instruments.
`get_market_components`	Constituents of stock indices.
`get_market_stocks_by_country`	Stocks listed in one or more countries.
`get_stock_description`	Company profiles.
`get_market_discontinued`	Discontinued market symbols.

Company financials and corporate events

Tool	Summary
`get_financials`	Latest financial statement data.
`get_financials_historical`	History of a financial metric.
`get_financial_reference`	Lists of companies, sectors and financial metrics.
`get_earnings`	Earnings and revenue calendar.
`get_earnings_by_sector`	Earnings and revenue by sector.
`get_dividends`	Dividend calendar.
`get_ipo`	IPO calendar.
`get_stock_splits`	Stock split calendar.

Countries and credit ratings

Tool	Summary
`get_countries`	Countries covered, with ISO codes.
`get_credit_ratings`	Latest sovereign credit ratings.
`get_credit_rating_updates`	Most recent rating changes.
`get_credit_ratings_historical`	History of sovereign rating actions.

News

Tool	Summary
`get_news`	Trading Economics news and analysis.

Tool categories

Category	Tools	Coverage
Catalog search	1	Keyword search across the whole Trading Economics catalog.
Economic indicators	9	Latest values, historical time series, related series, indicator catalog, updates, revisions and discontinued series.
Economic calendar	5	Scheduled and past releases by country, indicator, thematic group or ticker, and point-in-time calendar data.
Forecasts	3	Trading Economics forecasts for economic indicators and market prices.
Markets	15	Stock indices, stocks, currencies, commodities, government bonds and cryptocurrencies: snapshots, daily and intraday prices, search, symbology, peers, index constituents and company profiles.
Company financials and corporate events	8	Financial statements, earnings and revenue, dividends, IPOs and stock splits.
Countries and credit ratings	4	Country reference data and sovereign credit ratings.
News	1	Trading Economics news and analysis.

Tool reference

Catalog search

Start here when the exact name of an indicator, symbol or ticker is not known.

`search`

Search the whole Trading Economics catalog by keyword.

Resolves a free-text term (a country, an economic indicator, a market symbol, a company, a commodity, and so on) to matching identifiers. Use it to find the Symbol to pass to the data tools, such as get_indicator_data, get_historical_data or get_market_symbol, when only a name is known. To search market instruments only, you can also use get_market_search.

Parameter	Type	Required	Default	Allowed values / format	Description
`term`	string	Yes	—	Keyword or phrase	What to search for, for example `"gold"`, `"portugal gdp"` or `"inflation rate"`.
`category`	string (enum)	No	—	`markets`, `commodity`, `currency`, `index`, `economic`, `comtrade`, `wb` (World Bank), `fred` (Federal Reserve)	Restricts the results to one category. One value per request; any letter case is accepted. Omit to search every category.

Example

“Find the symbol for Brent crude oil.”

{ "term": "brent", "category": "commodity" }

Example response

{
  "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": [
    ["CO1:COM", "COG1", "Brent", "commodity", "2026-10-26T14:23:02.903", "commodity", 3, "OPEN", 114.9557, 114.9557, "2026-10-26T14:23:00", null, "/commodity/brent-crude-oil", 2, -1.7643, -1.51, 5.4057, 4.9345, 17.1257, 17.5056, 50.0557, 77.1274, 54.1057, 88.9165, 115.99, 114.75, 116.72, 109.55, 97.83, 64.9, 60.85, 147.5, "2008-07-11T00:00:00", 2.23, "1971-01-15T00:00:00", "", "USD/Bbl", "Live", "2026-10-26T14:23:00"]
  ]
}

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

Returns

Without category, or with economic, comtrade, wb or fred: one Symbol per result, with no name or value.
With markets, commodity, currency or index: market instruments with the market snapshot fields, including Symbol, Ticker, Name, Country, Type, Last, Close, MarketCap, URL, ISIN, unit, frequency and LastUpdate.

Notes

When nothing matches, the result is an empty list or a single row whose Symbol is "No results to show. ".
Results in the comtrade, wb and fred categories identify series that no tool on this server can retrieve.

Economic indicators

Latest values, historical time series, related series, and the updates and revisions of economic 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?”

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

Example response

{
  "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.”

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

Example response

{
  "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 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.”

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

Example response

{
  "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.”

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

Example response

{
  "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?”

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

Example response

{
  "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?”

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

Example response

{
  "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?”

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

Example response

{
  "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 or 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?”

{ "country": "brazil" }

Example response

{
  "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`

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?”

{}

Example response

{
  "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_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?”

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

Example response

{
  "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?”

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

Example response

{
  "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, 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.

Economic calendar

Scheduled and past economic releases, central bank meetings and other market-moving events.

Dates in calendar tools

startDate and endDate accept YYYY-MM-DD, YYYY-MM-DD HH:mm or YYYY-MM-DD HH:mm:ss, in UTC. A T is also accepted between the date and the time.
Provide startDate and endDate together, or neither.
An endDate without a time includes that whole day; an endDate with a time is the exact end of the range.

Event fields

Calendar tools return the Trading Economics calendar fields, including:

Field	Description
`CalendarId`	The identifier of the event, as text.
`Date`	Release date and time, in UTC.
`Country`, `Category`, `Event`	The country, the indicator category and the event name.
`Reference`, `ReferenceDate`	The period the release refers to, for example `"Oct"` and `"2026-10-31T00:00:00"`.
`Actual`	The released value; empty until the release.
`Previous`	The value for the previous period, after any revision.
`Revised`	The value for the previous period as originally reported, before the revision; empty when there was no revision.
`Forecast`	The consensus forecast.
`TEForecast`	The Trading Economics forecast.
`DateSpan`	The precision of `Date`, as text: `"0"` = the date and time are known, `"1"` = the date and time are estimated.
`Importance`	`1` = low, `2` = medium, `3` = high.
`Unit`, `Currency`	The unit and currency of the values.
`Source`, `SourceURL`	The official source of the release, and its website.
`URL`	The path of the indicator page on the Trading Economics website.
`Ticker`, `Symbol`	Identifiers of the underlying series.
`LastUpdate`	When the event record was last updated, in UTC.

Actual, Previous, Revised, Forecast and TEForecast are text that includes the unit or scale, for example "4.2%" or "7.079M", and are empty when no value is available.

Each request returns up to 1,000 events.

`get_calendar_by_country`

Calendar events, globally or for one country.

Returns economic calendar events for all countries or for one country, optionally within a date range and filtered by importance.

Parameter	Type	Required	Default	Allowed values / format	Description
`country`	string	No	—	Full country name, any letter case	For example `"united states"`. ISO codes are not supported. Omit for all countries.
`startDate`	string	No	—	Date, or date and time (UTC)	Start of the range.
`endDate`	string	No	—	Date, or date and time (UTC)	End of the range.
`importance`	integer	No	—	`1` (low), `2` (medium), `3` (high)	Returns only events of this importance.

Example

“Which high-importance US events are scheduled between November 2 and November 6, 2026?”

{ "country": "united states", "importance": 3, "startDate": "2026-11-02", "endDate": "2026-11-06" }

Example response

{
  "columns": ["CalendarId", "Date", "Country", "Category", "Event", "Reference", "ReferenceDate", "Source", "SourceURL", "Actual", "Previous", "Forecast", "TEForecast", "URL", "DateSpan", "Importance", "LastUpdate", "Revised", "Currency", "Unit", "Ticker", "Symbol"],
  "rows": [
    ["397194", "2026-11-02T14:00:00", "United States", "Business Confidence", "ISM Manufacturing PMI", "Oct", "2026-10-31T00:00:00", "Institute for Supply Management", "https://www.ismworld.org", "", "54.5", "", "", "/united-states/business-confidence", "0", 3, "2026-10-01T14:00:01.47", "", "", "", "NAPMPMI", "NAPMPMI"],
    ["399215", "2026-11-03T15:00:00", "United States", "Job Offers", "JOLTs Job Openings", "Sep", "2026-09-30T00:00:00", "U.S. Bureau of Labor Statistics", "http://www.bls.gov", "", "7.079M", "", "7.0M", "/united-states/job-offers", "0", 3, "2026-09-29T14:00:05.06", "", "", "", "UNITEDSTAJOBOFF", "UNITEDSTAJOBOFF"]
  ]
}

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

Returns

The event fields.

Notes

Without country and dates, the current calendar snapshot for all countries is returned.

`get_calendar_by_indicator`

Calendar events for one or more indicators.

Returns economic calendar events for one or more indicators across all countries, optionally within a date range and filtered by importance.

Parameter	Type	Required	Default	Allowed values / format	Description
`indicators`	string or string[]	Yes	—	Indicator names	For example `"inflation rate"` or `["inflation rate", "gdp"]`.
`startDate`	string	No	—	Date, or date and time (UTC)	Start of the range.
`endDate`	string	No	—	Date, or date and time (UTC)	End of the range.
`importance`	integer	No	—	`1` (low), `2` (medium), `3` (high)	Returns only events of this importance.

Example

“When are inflation and GDP growth figures released in November 2026?”

{ "indicators": ["inflation rate", "gdp growth rate"], "startDate": "2026-11-01", "endDate": "2026-11-30" }

Example response

{
  "columns": ["CalendarId", "Date", "Country", "Category", "Event", "Reference", "ReferenceDate", "Source", "SourceURL", "Actual", "Previous", "Forecast", "TEForecast", "URL", "DateSpan", "Importance", "LastUpdate", "Revised", "Currency", "Unit", "Ticker", "Symbol"],
  "rows": [
    ["412969", "2026-11-02T04:00:00", "Indonesia", "Inflation Rate", "Inflation Rate YoY", "Oct", "2026-10-31T00:00:00", "Statistics Indonesia", "https://www.bps.go.id/", "", "3.28%", "", "3.3%", "/indonesia/inflation-cpi", "0", 2, "2026-10-14T17:22:54.023", "", "", "%", "IDCPIY", "IDCPIY"],
    ["412459", "2026-11-02T07:00:00", "Kazakhstan", "Inflation Rate", "Inflation Rate YoY", "Oct", "2026-10-31T00:00:00", "Agency of the Republic of Kazakhstan on Statistics", "https://new.stat.gov.kz/", "", "9.3%", "", "", "/kazakhstan/inflation-cpi", "1", 1, "2026-10-01T10:51:03.39", "", "", "", "KAZAKHSTANIR", "KazakhstanIR"]
  ]
}

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

Returns

The event fields.

Notes

To filter by both country and indicator, use get_calendar_point_in_time.

`get_calendar_by_group`

Calendar events for a thematic group.

Returns economic calendar events for one thematic group across countries, optionally within a date range.

Parameter	Type	Required	Default	Allowed values / format	Description
`group`	string	Yes	—	`interest rate`, `inflation`, `bonds`, `consumer`, `gdp`, `government`, `housing`, `labour`, `markets`, `money`, `prices`, `trade`, `business`	The thematic group.
`startDate`	string	No	—	Date, or date and time (UTC)	Start of the range.
`endDate`	string	No	—	Date, or date and time (UTC)	End of the range.

Example

“Which labor market releases are scheduled between November 2 and November 6, 2026?”

{ "group": "labour", "startDate": "2026-11-02", "endDate": "2026-11-06" }

Example response

{
  "columns": ["CalendarId", "Date", "Country", "Category", "Event", "Reference", "ReferenceDate", "Source", "SourceURL", "Actual", "Previous", "Forecast", "TEForecast", "URL", "DateSpan", "Importance", "LastUpdate", "Revised", "Currency", "Unit", "Ticker", "Symbol"],
  "rows": [
    ["400361", "2026-11-02T00:30:00", "Australia", "Job Advertisements", "ANZ-Indeed Job Ads MoM", "Oct", "2026-10-31T00:00:00", "ANZ - Indeed Australian Job Ads", "https://media.anz.com/", "", "2.2%", "", "-1.4%", "/australia/job-advertisements", "0", 1, "2026-10-21T11:28:18.177", "", "", "%", "AUSTRALIAJOBADV", "AUSTRALIAJOBADV"],
    ["410595", "2026-11-02T07:30:00", "Austria", "Unemployment Rate", "Unemployment Rate", "Oct", "2026-10-31T00:00:00", "Public Employment Service Austria (AMS)", "https://www.ams.at", "", "7.1%", "", "7.7%", "/austria/unemployment-rate", "0", 1, "2026-10-22T14:32:57.117", "", "", "%", "UMRTAT", "UMRTAT"]
  ]
}

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

Returns

The event fields.

Notes

Use one of the listed group names. The calendar groups differ from the indicator category groups of get_indicator_data; for example, interest rate, inflation and bonds are calendar groups only.

`get_calendar_by_ticker`

Calendar events for one or more tickers.

Returns economic calendar events for one or more Trading Economics tickers, optionally within a date range.

Parameter	Type	Required	Default	Allowed values / format	Description
`tickers`	string or string[]	Yes	—	Trading Economics tickers	For example `"IJCUSA"` or `["IJCUSA", "SPAINFACORD"]`.
`startDate`	string	No	—	Date, or date and time (UTC)	Start of the range.
`endDate`	string	No	—	Date, or date and time (UTC)	End of the range.

Example

“When are the next US initial jobless claims released?”

{ "tickers": "IJCUSA" }

Example response

{
  "columns": ["CalendarId", "Date", "Country", "Category", "Event", "Reference", "ReferenceDate", "Source", "SourceURL", "Actual", "Previous", "Forecast", "TEForecast", "URL", "DateSpan", "Importance", "LastUpdate", "Revised", "Currency", "Unit", "Ticker", "Symbol"],
  "rows": [
    ["397151", "2026-10-29T12:30:00", "United States", "Initial Jobless Claims", "Initial Jobless Claims", "Oct/24", "2026-10-24T00:00:00", "U.S. Department of Labor", "https://www.dol.gov/", "", "194K", "200K", "196.0K", "/united-states/jobless-claims", "0", 2, "2026-10-26T08:30:41.187", "", "", "K", "IJCUSA", "IJCUSA"],
    ["397108", "2026-10-22T12:30:00", "United States", "Initial Jobless Claims", "Initial Jobless Claims", "Oct/17", "2026-10-17T00:00:00", "U.S. Department of Labor", "https://www.dol.gov/", "194K", "200K", "200K", "200.0K", "/united-states/jobless-claims", "0", 2, "2026-10-22T12:30:01.927", "199K", "", "K", "IJCUSA", "IJCUSA"]
  ]
}

Retrieved on October 26, 2026; truncated to 2 rows: the next scheduled release and the latest published one. Values change over time.

Returns

The event fields.

Notes

To find a ticker, use the HistoricalDataSymbol field of get_indicator_data, or search.
Without dates, the result includes both the scheduled releases and the releases of roughly the past year, most recent first.

`get_calendar_point_in_time`

Calendar events as originally published.

Returns calendar events for one country and one indicator as they appeared at the time of release, preserving the original values before any later revision. Use it for backtesting and research without look-ahead bias.

Parameter	Type	Required	Default	Allowed values / format	Description
`country`	string	Yes	—	Full country name, any letter case	For example `"united states"`. ISO codes are not supported.
`indicator`	string	Yes	—	Indicator name	For example `"initial jobless claims"`.
`startDate`	string	Yes	—	Date, or date and time (UTC)	Start of the range.
`endDate`	string	Yes	—	Date, or date and time (UTC)	End of the range.

Example

“Show US initial jobless claims as published between December 1, 2016 and February 25, 2017.”

{
  "country": "united states",
  "indicator": "initial jobless claims",
  "startDate": "2016-12-01",
  "endDate": "2017-02-25"
}

Example response

{
  "columns": ["CalendarId", "Date", "Country", "Category", "Event", "Reference", "ReferenceDate", "Source", "SourceURL", "Actual", "Previous", "Forecast", "TEForecast", "URL", "DateSpan", "Importance", "LastUpdate", "Revised", "Currency", "Unit", "Ticker", "Symbol"],
  "rows": [
    ["87213", "2016-12-01T13:30:00", "United States", "Initial Jobless Claims", "Initial Jobless Claims", "Nov/26", "2016-11-26T00:00:00", "U.S. Department of Labor", "https://www.dol.gov/", "268K", "251K", "253K", "253.1K", "/united-states/jobless-claims", "0", 2, "2016-12-01T13:30:00", "", "", "K", "IJCUSA", "IJCUSA"],
    ["87229", "2016-12-08T13:30:00", "United States", "Initial Jobless Claims", "Initial Jobless Claims", "Dec/03", "2016-12-03T00:00:00", "U.S. Department of Labor", "https://www.dol.gov/", "258K", "268K", "258K", "263K", "/united-states/jobless-claims", "0", 2, "2016-12-08T13:31:00", "", "", "K", "IJCUSA", "IJCUSA"]
  ]
}

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

Returns

The event fields.

Notes

All four parameters are required.
An ISO code such as "us" is not rejected, but returns no events.

Forecasts

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 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?”

{ "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 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.

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 symbols is provided, category is ignored. Without either, the forecasts for stock indices are returned.

Markets

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

Market symbols use the format {ticker}:{exchange or type}, for example "aapl:us", "spx:ind" or "eurusd:cur". Use search, get_market_search or 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_currencies, get_crypto, get_bonds and get_market_stocks_by_country in snapshot mode return Group, State and StartDate.
get_commodities, get_market_symbol, get_market_search and search return Type, state, MarketCap and ISIN.
get_market_peers and 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?”

{}

Example response

{
  "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 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 with that country and the category index.
Pass the Symbol of an index as the index of get_earnings or the symbol of 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?”

{ "commodity": "gold" }

Example response

{
  "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 of each commodity. Country is "commodity".

Notes

Current prices only. For historical prices, use 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.”

{ "cross": "EUR" }

Example response

{
  "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 of each currency pair.

Notes

For historical rates, use 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?”

{}

Example response

{
  "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 of each cryptocurrency, priced in US dollars.

Notes

For historical prices, use 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.”

{ "type": "10Y" }

Example response

{
  "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 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?”

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

Example response

{
  "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 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 or 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.”

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

Example response

{
  "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`

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.”

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

Example response

{
  "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?”

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

Example response

{
  "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 of each matching instrument.

Notes

Exactly one of country or term is required.
To search the whole catalog, including economic indicators, use 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?”

{ "isin": "US0378331005" }

Example response

{
  "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?”

{ "symbol": "aapl:us" }

Example response

{
  "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 of each peer instrument, plus relationship.

Notes

To find a symbol, use get_market_search or 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?”

{ "symbol": "psi20:ind" }

Example response

{
  "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 of each member of the index, plus relationship.

Notes

Use 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?”

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

Example response

{
  "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 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 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_historical or 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?”

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

Example response

{
  "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?”

{}

Example response

{
  "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.

Company financials and corporate events

Financial statement data, and the calendars of earnings, dividends, IPOs and stock splits.

`get_financials`

Latest financial statement data.

Returns the latest four reporting periods of financial statement data: every metric for one company, or one metric across all companies.

Parameter	Type	Required	Default	Allowed values / format	Description
`symbol`	string	Conditional	—	`{ticker}:{exchange}`	For example `"aapl:us"`. Returns every financial metric for this company. Takes priority over `category`.
`category`	string	Conditional	—	Financial metric name	For example `"assets"`, `"net-income"` or `"eps"`. Returns this metric across all companies.

Example

“Show Apple’s latest financial statements.”

{ "symbol": "aapl:us" }

Example response

{
  "columns": ["Symbol", "Date", "last", "value1", "date1", "value2", "date2", "value3", "date3", "value4", "date4", "unit", "currency", "frequency", "stock", "financialSymbol"],
  "rows": [
    ["aapl:us:assets", "2026-06-30T00:00:00", 383266, 383266, "2026-06-30T00:00:00", 371082, "2026-03-31T00:00:00", 379297, "2025-12-31T00:00:00", 359241, "2025-09-30T00:00:00", "E+06", "USD", "quarterly", "aapl:us", "assets"],
    ["aapl:us:eps", "2026-06-30T00:00:00", 2.02, 2.02, "2026-06-30T00:00:00", 2.01, "2026-03-31T00:00:00", 2.84, "2025-12-31T00:00:00", 1.85, "2025-09-30T00:00:00", "E+00", "USD", "quarterly", "aapl:us", "eps"]
  ]
}

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

Returns

Field	Description
`Symbol`	Compound key, for example `"aapl:us:assets"`.
`stock`, `financialSymbol`	The stock and the financial metric.
`Date`	The date of the latest record.
`last`	The latest reported value.
`value1` to `value4`, `date1` to `date4`	The four latest periods, newest first.
`currency`	The reporting currency.
`unit`	The scale of every value, for example `"E+06"` = millions.
`frequency`	The length of each period: `"quarterly"`, `"semesterly"` or `"yearly"`.

Notes

At least one of symbol or category is required.
Pass the Symbol compound key to get_financials_historical as symbolCategory.
Use get_financial_reference with type "categories" to list valid metric names.

`get_financials_historical`

History of a financial metric.

Returns the full history of a financial metric for one or more companies.

Parameter	Type	Required	Default	Allowed values / format	Description
`symbolCategory`	string	Yes	—	`{ticker}:{exchange}:{metric}`, comma-separated	For example `"aapl:us:assets"` or `"aapl:us:assets,msft:us:assets"`.
`startDate`	string	No	—	`YYYY-MM-DD`	Start of the range.
`endDate`	string	No	—	`YYYY-MM-DD`	End of the range. Takes effect only with `startDate`.

Example

“Compare Apple’s and Microsoft’s total assets since 2020.”

{ "symbolCategory": "aapl:us:assets,msft:us:assets", "startDate": "2020-01-01" }

Example response

{
  "columns": ["symbol", "category", "date", "value", "reportDate", "reference"],
  "rows": [
    ["aapl:us", "assets", "2020-03-31T00:00:00", 320400, "2020-03-31T00:00:00", "FY2020Q2"],
    ["msft:us", "assets", "2026-06-30T00:00:00", 758376, "2026-07-29T00:00:00", "FY2026Q4"]
  ]
}

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

Returns

symbol (for example, "aapl:us"), category (for example, "assets"), date (period end), value, reportDate, reference (fiscal period, for example "FY2024Q4").

Notes

There is no unit field. The values use the unit that get_financials returns for the same compound key.

`get_financial_reference`

Lists of companies, sectors and financial metrics.

Returns the valid names to use with the other financial tools: the companies covered, the sector names, or the financial metric categories.

Parameter	Type	Required	Default	Allowed values / format	Description
`type`	string (enum)	Yes	—	`companies`, `sectors`, `categories`	`companies`: the companies covered. `sectors`: sector names for `get_earnings_by_sector`. `categories`: metric names for `get_financials`.
`country`	string	No	—	Country names, comma-separated, up to 5	For example `"united states"` or `"spain,germany"`. Applies only with `type` `"companies"`.

Example

“Which sectors can I query earnings for?”

{ "type": "sectors" }

Example response

{
  "columns": ["Sector"],
  "rows": [
    ["Accommodation and Food Services"],
    ["Communication Services"]
  ]
}

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

Returns

companies: Symbol, Name, Country.
sectors: Sector.
categories: Category, the metric name to pass to get_financials (for example "net-income"), and Name, its display name (for example "Net Income").

Notes

country has no effect with type "sectors" or "categories".

`get_earnings`

Earnings and revenue calendar.

Returns the corporate earnings and revenue calendar by company, country or stock index, optionally within a date range.

Parameter	Type	Required	Default	Allowed values / format	Description
`symbol`	string	No	—	`{ticker}:{exchange}`	For example `"aapl:us"`. Takes priority over `country` and `index`.
`country`	string	No	—	Country name	For example `"mexico"`. Takes priority over `index`.
`index`	string	No	—	Index symbol	For example `"spx:ind"`. Returns the companies of this index.
`startDate`	string	No	—	`YYYY-MM-DD`	Start of the range.
`endDate`	string	No	—	`YYYY-MM-DD`	End of the range. Takes effect only with `startDate`.

Example

“Which S&P 500 companies report earnings between October 26 and October 30, 2026?”

{ "index": "spx:ind", "startDate": "2026-10-26", "endDate": "2026-10-30" }

Example response

{
  "columns": ["Date", "Symbol", "Name", "Actual", "ActualValue", "Forecast", "ForecastValue", "Previous", "PreviousValue", "Revenue", "RevenueValue", "RevenueForecast", "RevenueForecastValue", "RevenuePrevious", "RevenuePreviousValue", "MarketCapUSD", "FiscalTag", "FiscalReference", "CalendarReference", "Country", "Currency", "Importance", "Session", "MarketRelease", "LastUpdate"],
  "rows": [
    ["2026-10-26", "CDNS:US", "Cadence Design Systems", "", null, "1.92", 1.92, "1.93", 1.93, "", null, "1.55B", 1550000000, "1.34B", 1340000000, 91697100000, "FY2026Q3", "Q3", "2026-09-30", "United States", "USD", 3, 21, "after_close", "2026-10-23T16:59:00"],
    ["2026-10-26", "HIG:US", "Hartford Financial Services", "", null, "3.11", 3.11, "3.78", 3.78, "", null, "7.41B", 7410000000, "7.23B", 7230000000, 42277200000, "FY2026Q3", "Q3", "2026-09-30", "United States", "USD", 3, 21, "after_close", "2026-10-23T16:59:00"]
  ]
}

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

Returns

Fields	Description
`Date`, `Symbol`, `Name`, `Country`, `Currency`, `MarketCapUSD`	The event and the company.
`Actual`, `Forecast`, `Previous`	Earnings per share, as text.
`ActualValue`, `ForecastValue`, `PreviousValue`	Earnings per share, as numbers.
`Revenue`, `RevenueForecast`, `RevenuePrevious`	Revenue as text, for example `"1.72B"`.
`RevenueValue`, `RevenueForecastValue`, `RevenuePreviousValue`	Revenue as numbers, for example `1720000000`.
`FiscalTag`, `FiscalReference`	The fiscal period, for example `"FY2026Q3"`, and the fiscal quarter, for example `"Q3"`.
`CalendarReference`	The calendar date of the fiscal quarter end.
`Importance`	`1` = low to `3` = high.
`Session`, `MarketRelease`	The expected release hour (UTC), and the release timing: `before_open`, `after_close` or `by_day_end`.
`LastUpdate`	When the record was last updated, in UTC.

Notes

Without filters, the upcoming earnings calendar is returned.
Use the numeric *Value fields for calculations. Actual, Revenue and their numeric fields are empty for results not yet reported.
Use get_stock_indices to find index symbols.

`get_earnings_by_sector`

Earnings and revenue by sector.

Returns corporate earnings and revenue for one sector, optionally within a date range.

Parameter	Type	Required	Default	Allowed values / format	Description
`sector`	string	Yes	—	Sector name	For example `"technology"` or `"health care"`.
`startDate`	string	No	—	`YYYY-MM-DD`	Start of the range.
`endDate`	string	No	—	`YYYY-MM-DD`	End of the range. Takes effect only with `startDate`.

Example

“Which technology companies report earnings in October 2026?”

{ "sector": "technology", "startDate": "2026-10-01", "endDate": "2026-10-31" }

Example response

{
  "columns": ["Date", "Symbol", "Name", "Actual", "ActualValue", "Forecast", "ForecastValue", "Previous", "PreviousValue", "Revenue", "RevenueValue", "RevenueForecast", "RevenueForecastValue", "RevenuePrevious", "RevenuePreviousValue", "MarketCapUSD", "FiscalTag", "FiscalReference", "CalendarReference", "Country", "Currency", "Importance", "Session", "MarketRelease", "LastUpdate"],
  "rows": [
    ["2026-10-01", "ACN:US", "Accenture", "3.29", 3.29, "3.18", 3.18, "3.03", 3.03, "18.7B", 18700000000, "18.05B", 18050000000, "17.6B", 17600000000, 142890900000, "FY2026Q4", "Q4", "2026-06-30", "Ireland", "USD", 2, 13, "before_open", "2026-10-08T11:29:00"],
    ["2026-10-14", "ASML:NA", "ASML Holding", "12.93", 12.93, "8.50", 8.5, "5.48", 5.48, "11.66B", 11660000000, "10.33B", 10330000000, "7.52B", 7520000000, 655709005594, "FY2026Q3", "Q3", "2026-09-30", "Netherlands", "EUR", 3, 24, "by_day_end", "2026-10-14T07:06:00"]
  ]
}

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

Returns

The same fields as get_earnings.

Notes

Use get_financial_reference with type "sectors" to list valid sector names.

`get_dividends`

Dividend calendar.

Returns the dividend calendar, with ex-dividend dates, payment dates and amounts per share, for one company or for all companies.

Parameter	Type	Required	Default	Allowed values / format	Description
`symbol`	string	No	—	`{ticker}:{exchange}`	For example `"aapl:us"`. Omit for all companies.
`startDate`	string	No	—	`YYYY-MM-DD`	Start of the range.
`endDate`	string	No	—	`YYYY-MM-DD`	End of the range. Takes effect only with `startDate`.

Example

“Which dividends did Apple pay in 2025?”

{ "symbol": "aapl:us", "startDate": "2025-01-01", "endDate": "2025-12-31" }

Example response

{
  "columns": ["DateEx", "Symbol", "Name", "Actual", "DatePayment", "Currency", "LastUpdate"],
  "rows": [
    ["2025-02-10", "AAPL:US", "Apple", 0.25, "2025-02-13", "USD", "2025-03-10T07:23:00"],
    ["2025-05-12", "AAPL:US", "Apple", 0.26, "2025-05-15", "USD", "2025-05-16T20:11:00"]
  ]
}

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

Returns

DateEx (ex-dividend date), Symbol, Name, Actual (dividend per share), DatePayment, Currency, LastUpdate (UTC).

Notes

Without symbol, the dividends of all companies are returned.

`get_ipo`

IPO calendar.

Returns the calendar of initial public offerings by ticker or by country, optionally within a date range.

Parameter	Type	Required	Default	Allowed values / format	Description
`ticker`	string	Conditional	—	IPO ticker	For example `"RRKA"`. Takes priority over `country`.
`country`	string	Conditional	—	Country name	For example `"india"`.
`startDate`	string	No	—	`YYYY-MM-DD`	Start of the range.
`endDate`	string	No	—	`YYYY-MM-DD`	End of the range. Takes effect only with `startDate`.

Example

“Which IPOs are scheduled in India until the end of 2026?”

{ "country": "india", "startDate": "2026-10-01", "endDate": "2026-12-31" }

Example response

{
  "columns": ["Date", "Ticker", "Country", "Exchange", "Symbol", "Name", "Value", "StartPrice", "Currency", "LastUpdate"],
  "rows": [
    ["2026-10-23T00:00:00", "BONF", "India", "BSE", "", "Bonfiglioli Transmissions Ltd", "25.3B", "558.00-586.00", "INR", "2026-10-22T10:14:00"],
    ["2026-10-23T00:00:00", "BONF", "India", "NSE", "", "Bonfiglioli Transmissions Ltd", "25.3B", "558.00-586.00", "INR", "2026-10-22T10:14:00"]
  ]
}

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

Returns

Date, Ticker, Country, Exchange, Symbol (often empty), Name, Value (offer amount as text, for example "200.0M"), StartPrice (price per share as text, for example "10.00", or a price range such as "558.00-586.00"), Currency, LastUpdate (UTC).

Notes

At least one of ticker or country is required.
An IPO listed on several exchanges returns one row per exchange.

`get_stock_splits`

Stock split calendar.

Returns the stock split calendar by ticker, by country, or for all countries.

Parameter	Type	Required	Default	Allowed values / format	Description
`ticker`	string	No	—	Stock ticker	For example `"DEIN"`. Takes priority over `country`.
`country`	string	No	—	Country name	For example `"india"`.
`startDate`	string	No	—	`YYYY-MM-DD`	Start of the range. Not accepted with `ticker`.
`endDate`	string	No	—	`YYYY-MM-DD`	End of the range. Requires `startDate`. Not accepted with `ticker`.

Example

“Which stock splits took place in India in 2025?”

{ "country": "india", "startDate": "2025-01-01", "endDate": "2025-12-31" }

Example response

{
  "columns": ["Date", "Ticker", "Country", "Symbol", "Name", "Ratio", "LastUpdate"],
  "rows": [
    ["2025-01-03T00:00:00", "MCNL", "India", "", "McNally Bharat Engg Co Ltd", "1:20", "2025-01-31T08:51:00"],
    ["2025-01-10T00:00:00", "SHMF", "India", "SHFL:IN", "Shriram Finance", "5:1", "2025-01-31T08:51:00"]
  ]
}

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

Returns

Date, Ticker, Country, Symbol (often empty), Name, Ratio (new shares to old shares, for example "2:1"; a ratio such as "1:20" is a reverse split), LastUpdate (UTC).

Notes

Without ticker and country, the splits of all countries are returned.
Without startDate, only recent and upcoming splits are returned. Records start in September 2023.
A ticker is matched in every country, so it can return different companies; check Country and Name.

Countries and credit ratings

Country reference data, and sovereign credit ratings from S&P and DBRS.

`get_countries`

Countries covered, with ISO codes.

Returns every country covered by Trading Economics, with its continent, regional group and ISO codes.

This tool takes no parameters.

Example

“Which countries does Trading Economics cover?”

{}

Example response

{
  "columns": ["Country", "Continent", "Group", "ISO3", "ISO2"],
  "rows": [
    ["Afghanistan", "Asia", "Asia", "AFG", "AF"],
    ["Albania", "Europe", "Europe", "ALB", "AL"]
  ]
}

Retrieved on October 26, 2026; truncated to the first 2 rows.

Returns

Country, Continent, Group, ISO3, ISO2.

Notes

Use the Country names as the country parameters of the other tools.
The list also includes aggregates, such as "Euro area", "European Union" and "World".

`get_credit_ratings`

Latest sovereign credit ratings.

Returns the latest sovereign credit ratings and outlooks from S&P and DBRS, for all countries or for specific countries.

Parameter	Type	Required	Default	Allowed values / format	Description
`country`	string or string[]	No	—	Country names	For example `"sweden"` or `["italy", "spain"]`. Omit for all countries.

Example

“What are the latest credit ratings for Italy and Spain?”

{ "country": ["italy", "spain"] }

Example response

{
  "columns": ["Country", "Date", "Agency", "Rating", "Outlook"],
  "rows": [
    ["Italy", "1/30/2026", "S&P", "BBB+", "Positive"],
    ["Italy", "10/17/2025", "DBRS", "A (low)", "Stable"]
  ]
}

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

Returns

Country, Date, Agency, Rating, Outlook.

Notes

For recent rating changes, use get_credit_rating_updates; for the history of ratings, use get_credit_ratings_historical.
Date uses the format M/D/YYYY, for example "1/30/2026".

`get_credit_rating_updates`

Most recent rating changes.

Returns the most recent sovereign credit rating changes across all countries and agencies.

This tool takes no parameters.

Example

“Which sovereign ratings changed recently?”

{}

Example response

{
  "columns": ["Country", "Date", "Agency", "Rating", "Outlook", "LastUpdate"],
  "rows": [
    ["Togo", "10/16/2026", "S&P", "B+", "Positive", "10/19/2026 10:40:00 AM"],
    ["Mozambique", "9/25/2026", "S&P", "CCC", "Negative", "9/28/2026 9:02:00 AM"]
  ]
}

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

Returns

Country, Date (when the agency released the rating), Agency, Rating, Outlook, LastUpdate (when the record was last updated, which can be later than Date).

Notes

The records are not returned in any guaranteed order. Sort by Date when chronology matters.
Date uses the format M/D/YYYY, and LastUpdate the format M/D/YYYY h:mm:ss AM/PM.

`get_credit_ratings_historical`

History of sovereign rating actions.

Returns the history of sovereign credit rating actions, for all countries or for specific countries.

Parameter	Type	Required	Default	Allowed values / format	Description
`country`	string or string[]	No	—	Country names	For example `"portugal"` or `["mexico", "sweden"]`. Omit for all countries.
`startDate`	string	No	—	`YYYY-MM-DD`	Start of the range.
`endDate`	string	No	—	`YYYY-MM-DD`	End of the range. Requires `startDate`.

Example

“Show the full credit rating history of Portugal.”

{ "country": "portugal", "startDate": "1900-01-01" }

Example response

{
  "columns": ["Country", "Date", "Agency", "Rating", "Outlook"],
  "rows": [
    ["Portugal", "5/15/2026", "DBRS", "A (high)", "Positive"],
    ["Portugal", "2/27/2026", "S&P", "A+", "Positive"]
  ]
}

Retrieved on October 26, 2026; truncated to the first 2 of 52 rows, most recent first.

Returns

Country, Date, Agency, Rating, Outlook.

Notes

Without startDate, only recent rating actions are returned, so a country with no recent action returns an empty list. Use "1900-01-01" as startDate for the full history.

News

Trading Economics news and analysis.

`get_news`

Trading Economics news and analysis.

Returns economic and market news articles: short summaries that explain the release or event behind a data move. The mode depends on the parameters provided, resolved in this priority order:

Ticker mode: news about one series.
Country and indicator mode: news about one indicator in one country.
Country mode: all news about one country.
Indicator mode: news about one or more indicators across all countries.

Without any of these parameters, the latest global news is returned, optionally filtered by type.

Parameter	Type	Required	Default	Allowed values / format	Description
`ticker`	string	No	—	Trading Economics ticker	For example `"CZCAEUR"`. Takes priority over `country` and `indicator`.
`country`	string	No	—	Full country name, any letter case	For example `"mexico"`. ISO codes are not supported.
`indicator`	string	No	—	Indicator name	For example `"inflation rate"`. Without `country`, several indicators can be comma-separated, for example `"inflation rate,gdp"`.
`type`	string (enum)	No	—	`markets`, `economy`	News category. Applies only to the global news.
`startDate`	string	No	—	`YYYY-MM-DD`	Start of the range.
`endDate`	string	No	—	`YYYY-MM-DD`	End of the range. Takes effect only with `startDate`.
`limit`	integer	No	—	1 or greater	Maximum number of articles to return.
`start`	integer	No	—	0 or greater	Number of articles to skip, for pagination.

Example

“Show the 10 latest news items about inflation in Germany.”

{ "country": "germany", "indicator": "inflation rate", "limit": 10 }

Example response

{
  "columns": ["id", "title", "date", "description", "country", "category", "symbol", "url", "importance"],
  "rows": [
    ["591379", "German Inflation Confirmed at Near 3-Year High", "2026-10-13T06:05:04.59", "Germany’s annual inflation rate accelerated to 3.3% in September 2026, confirming preliminary estimates, up from 2.9% in August. ...", "Germany", "Inflation Rate", "GRBC20YY", "/germany/inflation-cpi", 1],
    ["588240", "German Inflation Hits Highest Level Since 2023", "2026-09-30T12:07:37.867", "Germany’s annual inflation rate rose to 3.3% in September 2026, its highest level since December 2023 and above market expectations of 3.2%, according to preliminary estimates. ...", "Germany", "Inflation Rate", "GRBC20YY", "/germany/inflation-cpi", 3]
  ]
}

Retrieved on October 26, 2026; truncated to 2 of 10 rows, with description shortened. Values change over time.

Returns

id, title, date, description, country, category, symbol, url and importance for each article, most recent first. The field names are in lowercase; symbol identifies the underlying series.

Notes

type is ignored when ticker, country or indicator is provided.
Pass the symbol of an article as the ticker of get_indicator_data or get_historical_data to retrieve the underlying series.
Date ranges and pagination apply in every mode.