Skip to content
Docs
Get API key
Tools

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:

FieldDescription
Symbol, Ticker, Name, CountryThe instrument identifiers, its name and its country.
Type or GroupThe instrument type, for example "stocks", "index" or "commodity", or the market group, for example "America G20 Major".
State or stateThe market state, "OPEN" or "CLOSED".
Last, DateThe latest price (the yield, for bonds) and its timestamp.
Close, CloseDateThe latest closing price and its date.
DailyChange, WeeklyChange, MonthlyChange, YearlyChange, YTDChangeThe change over each period.
DailyPercentualChange, WeeklyPercentualChange, MonthlyPercentualChange, YearlyPercentualChange, YTDPercentualChangeThe same changes, in percent.
day_high, day_lowThe range of the current trading day.
yesterday, lastWeek, lastMonth, lastYear, startYearThe reference prices for those changes.
allTimeHigh, allTimeHighDate, allTimeLow, allTimeLowDateThe all-time high and low, with their dates.
MarketCap, ISINThe market capitalization and the ISIN; null or empty when not applicable.
unit, decimals, frequencyThe price unit, the number of decimals, and the update frequency, for example "Live", "Delayed" or "Daily".
URL, Importance, StartDate, LastUpdateThe 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

Snapshot of stock market indices worldwide.

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

This tool takes no parameters.

Example

“How are the world’s stock markets performing today?”

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

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

Returns

The market snapshot fields 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.

ParameterTypeRequiredDefaultAllowed values / formatDescription
commoditystringNo—Commodity nameFor example "gold" or "crude-oil". Returns the commodities that match this name. Omit for all commodities.

Example

“What is the price of gold?”

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

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

Returns

The market snapshot fields of each commodity. Country is "commodity".

Notes

get_currencies

Exchange rates.

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

ParameterTypeRequiredDefaultAllowed values / formatDescription
crossstringNo—Currency codeFor example "EUR" or "USD". Returns all the pairs of this currency.

Example

“Show all the exchange rates of the euro.”

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

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

Returns

The market snapshot fields 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?”

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

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

Returns

The market snapshot fields of each cryptocurrency, priced in US dollars.

Notes

get_bonds

Government bond yields.

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

ParameterTypeRequiredDefaultAllowed values / formatDescription
countrystringNo—Country nameFor example "france" or "united states".
typestring (enum)No—1M, 3M, 6M, 52W, 2Y, 3Y, 5Y, 7Y, 10Y, 15Y, 20Y, 30YThe bond maturity.

Example

“Compare 10-year government bond yields across countries.”

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

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

Returns

The market snapshot fields 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.

ParameterTypeRequiredDefaultAllowed values / formatDescription
symbolsstringYes—Market symbols, comma-separatedFor example "aapl:us" or "aapl:us,msft:us,eurusd:cur".

Example

“What are Apple’s and Microsoft’s share prices, and the EUR/USD exchange rate?”

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

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

Returns

The market snapshot fields of each symbol, including Last, DailyChange, DailyPercentualChange, MarketCap, ISIN, Type, state and LastUpdate.

Notes

get_market_historical

Daily price history.

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

ParameterTypeRequiredDefaultAllowed values / formatDescription
symbolsstringYes—Market symbols, comma-separatedFor example "aapl:us" or "aapl:us,msft:us".
startDatestringNo—YYYY-MM-DDStart of the range.
endDatestringNo—YYYY-MM-DDEnd of the range. Requires startDate.

Example

“Show Apple’s and Microsoft’s daily prices in 2025.”

JSON
{ "symbols": "aapl:us,msft:us", "startDate": "2025-01-01", "endDate": "2025-12-31" }
Example response
JSON
{
  "columns": ["Symbol", "Date", "Open", "High", "Low", "Close"],
  "rows": [
    ["AAPL:US", "31/12/2025", 273.06, 273.67999, 271.75, 271.85999],
    ["MSFT:US", "31/12/2025", 487.84, 488.14001, 483.29999, 483.62]
  ]
}

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

Returns

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

Notes

  • The Date field of the response uses the format dd/MM/yyyy, unlike the YYYY-MM-DD dates of the request.
  • For prices within the trading day, use get_market_intraday.

get_market_intraday

Intraday price data.

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

ParameterTypeRequiredDefaultAllowed values / formatDescription
symbolsstringYes—Market symbols, comma-separated; at most 5For example "aapl:us".
intervalstring (enum)No1h1m, 5m, 10m, 15m, 30m, 1h, 2h, 4hThe interval of each price bar.
startDatestringNo—YYYY-MM-DD or YYYY-MM-DD HH:mm (24-hour, UTC)Start of the range. A date without a time means 00:00.
endDatestringNo—YYYY-MM-DD or YYYY-MM-DD HH:mm (24-hour, UTC)End of the range. Requires startDate and must not be earlier than it.

Example

“Show Apple’s 15-minute prices on October 20, 2026, from 13:30 to 20:00 UTC.”

JSON
{ "symbols": "aapl:us", "interval": "15m", "startDate": "2026-10-20 13:30", "endDate": "2026-10-20 20:00" }
Example response
JSON
{
  "columns": ["Symbol", "Date", "Open", "High", "Low", "Close"],
  "rows": [
    ["AAPL:US", "2026-10-20T20:00:00", 339.39, 339.63, 339.2, 339.35],
    ["AAPL:US", "2026-10-20T19:45:00", 339.35, 339.49, 339.01, 339.4]
  ]
}

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

Returns

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

Notes

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

Search market instruments.

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

ParameterTypeRequiredDefaultAllowed values / formatDescription
countrystringConditional—Full country nameFor example "united states".
termstringConditional—Search termFor example "msft" or "apple".
categorystringNo—One or more of index, markets, forex, bond, commodity, comma-separated, in lowercaseFor example "index" or "index,markets". Omit to search all categories.

Example

“Which stock indices are there in Portugal?”

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

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

Returns

The market snapshot fields 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.

ParameterTypeRequiredDefaultAllowed values / formatDescription
symbolstringConditional—{ticker}:{exchange}For example "aapl:us".
tickerstringConditional—Bloomberg-style tickerFor example "aapl".
isinstringConditional—ISIN codeFor example "US0378331005".
countrystringConditional—Country nameFor example "mexico". Returns the instruments of this country.

Example

“Which instrument has the ISIN US0378331005?”

JSON
{ "isin": "US0378331005" }
Example response
JSON
{
  "columns": ["Symbol", "Ticker", "ISIN", "Name", "Country"],
  "rows": [
    ["AAPL:US", "AAPL", "US0378331005", "Apple", "United States"]
  ]
}

Retrieved on October 26, 2026; complete response.

Returns

Symbol, Ticker, ISIN, Name, Country.

Notes

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

get_market_peers

Comparable instruments.

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

ParameterTypeRequiredDefaultAllowed values / formatDescription
symbolstringYes—{ticker}:{exchange}For example "aapl:us".

Example

“Which stocks are comparable to Apple?”

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

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

Returns

The market snapshot fields 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.

ParameterTypeRequiredDefaultAllowed values / formatDescription
symbolstringYes—Index symbols, comma-separatedFor example "psi20:ind" or "psi20:ind,spx:ind".

Example

“Which companies are in the PSI index?”

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

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

Returns

The market snapshot fields of each member of the index, plus relationship.

Notes

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.

ParameterTypeRequiredDefaultAllowed values / formatDescription
countrystringYes—Country names, comma-separatedFor example "portugal" or "united states,nigeria".
modestring (enum)Nosnapshotsnapshot, listsnapshot: current market data for each stock. list: lightweight metadata only, smaller and faster.

Example

“Which stocks are listed in Portugal?”

JSON
{ "country": "portugal", "mode": "list" }
Example response
JSON
{
  "columns": ["Symbol", "Name", "Country", "Type", "URL", "Frequency", "Unit"],
  "rows": [
    ["ALTR:PL", "Altri", "Portugal", "stocks", "/altr:pl", "Daily", "EUR"],
    ["BCP:PL", "BCP", "Portugal", "stocks", "/bcp:pl", "Daily", "EUR"]
  ]
}

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

Returns

  • snapshot: the market snapshot fields of each stock, including Last, DailyChange, DailyPercentualChange, State and LastUpdate.
  • list: Symbol, Name, Country, Type, URL, Frequency, Unit.

Notes

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.

ParameterTypeRequiredDefaultAllowed values / formatDescription
symbolstringConditional—Stock symbols, comma-separatedFor example "aapl:us" or "aapl:us,msft:us".
countrystringConditional—Country nameFor example "france". Returns every company listed in this country.

Example

“What do Apple and Microsoft do?”

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

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

Returns

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

Notes

  • Exactly one of symbol or country is required.

get_market_discontinued

Discontinued market symbols.

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

This tool takes no parameters.

Example

“Which market symbols have been discontinued?”

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

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

Returns

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

Notes

  • The list covers all countries.