Market Tools
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_bondsandget_market_stocks_by_countryinsnapshotmode returnGroup,StateandStartDate.get_commodities,get_market_symbol,get_market_searchandsearchreturnType,state,MarketCapandISIN.get_market_peersandget_market_componentsalso returnrelationship, 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_searchwith that country and the categoryindex. - Pass the
Symbolof an index as theindexofget_earningsor thesymbolofget_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_historicalwith 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_historicalwith 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_historicalwith 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
countryortype. 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_searchorget_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
Datefield of the response uses the formatdd/MM/yyyy, unlike theYYYY-MM-DDdates 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
startDateearlier 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
countryortermis 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,isinorcountryis 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_searchorsearch. - 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_indicesto 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, includingLast,DailyChange,DailyPercentualChange,StateandLastUpdate.list:Symbol,Name,Country,Type,URL,Frequency,Unit.
Notes
- Neither mode returns the market capitalization; use
get_market_symbolfor it. - The
snapshotmode returns stocks only. Thelistmode can also include the country’s stock indices and government bonds; checkType. - Pass the
Symbolof a stock toget_market_symbol,get_market_historicalorget_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
symbolorcountryis 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.