Search

The API provides search functionality for Markets. By Default, the search will look into the categories: Indexes, markets (stocks), bonds, and commodities.

By country

Search for market data by a specific country

/markets/search/{country}

import tradingeconomics as te
te.login('your_api_key')

te.getMarketsSearch(country='united states')

const te = require('tradingeconomics');
te.login('your_api_key');

data = te.getMarketSnap(search_term = 'united states').then(function(data){
  console.log(data)     
});

WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/markets/search/united%20states?c=guest:guest");

Symbol	Ticker	Name	Country	Date	Type	URL	frequency
USGG10YR:IND	USGG10YR	US 10Y	United States	7/12/2023 4:43:28 PM	bond	/united-states/government-bond-yield	Delayed
USGG1M:IND	UNITEDSTA4WEEBILYIE	US 4W	United States	7/12/2023 4:04:33 PM	bond	/united-states/4-week-bill-yield	Delayed
USGG3M:IND	UNITEDSTA3MONBILYIE	US 3M	United States	7/12/2023 4:10:35 PM	bond	/united-states/3-month-bill-yield	Delayed

By country and category

Search for market data by a specific country and category (or categories)

Categories available: index, markets, forex, bond and commodity.

/markets/search/{country}?category={category}

te.getMarketsSearch(country='united states', category = 'index')

te.getMarketsSearch(country='united states', category = ['index', 'markets'])

data = te.getMarketSnap(search_term = 'united states',
 category = 'index').then(function(data){
  console.log(data)     
});

data = te.getMarketSnap(search_term = 'united states',
 category = ['index', 'markets']).then(function(data){
  console.log(data)     
});

WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/markets/search/united%20states?c=guest:guest&category=index");

WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/markets/search/united%20states?c=guest:guest&category=index,markets");

Symbol	Ticker	Name	Country	Date	Type	URL	frequency
INDU:IND	INDU	US30	United States	7/12/2023 4:52:34 PM	index	/united-states/stock-market	Live
VIX:IND	VIX	USVIX	United States	7/12/2023 5:07:16 PM	index	/vix:ind	Delayed
W5000:IND	W5000	US5000	United States	7/12/2023 4:52:00 PM	index	/w5000:ind	Delayed

By term

Search for market data by a specific term.

By Default, the search will look into the categories: Indexes, markets (stocks), bonds, and commodities.

/markets/search/{term}

te.getMarketsSearch(country ='msft')

data = te.getMarketSnap(search_term = 'msft').then(function(data){
  console.log(data)     
});

WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/markets/search/msft:?c=guest:guest");

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	ISIN	unit	frequency	LastUpdate
MSFT:US	MSFT	Microsoft	United States	7/12/2023 5:09:46 PM	stocks							/msft:us																			US5949181045		Live

Response fields

Field	Type	Description	Example
Symbol	string	Unique symbol used by Trading Economics	“6758:JP”
Ticker	string	Unique ticker used by Trading Economics	“6758”
Name	string	Indicator full name	“Sony”
Country	string	Country name	Japan"
Date	string	Release time and date in UTC	“2023-04-13T00:00:00”
Type	string	Market type	“stocks”
Decimals	number	Number of decimal places	2.0
State	string	Market current state	CLOSED"
Last	number	Latest released value	11900.000000000000
Close	number	Latest value before market close	11900.000000000000
CloseDate	string	Date and time of the last close	“2023-04-13T00:00:00”
MarketCap	number	Market Capitalization
URL	string	Hyperlink at Trading Economics	“/commodity/eggs-ch”
Importance	number	Indicator importance from 0 (lowest) to 1000 (highest)	1000
DailyChange	number	Difference between last close and current price	-8.000000000000
DailyPercentualChange	number	Difference in percentage between last close and current price	-0.1801
WeeklyChange	number	Difference between last week close and current price price	56.000000000000
WeeklyPercentualChange	number	Difference in percentage between last week close and current price	1.2788
MonthlyChange	number	Difference between last month close and current price	-139.000000000000
MonthlyPercentualChange	number	Difference in percentage between last month close and current price	-3.0389
YearlyChange	number	Difference between last year close and current price	-15.000000000000
YearlyPercentualChange	number	Difference in percentage between last year close and current price	-0.3371
YTDChange	number	Difference between last year last close and current price	525.000000000000
YTDPercentualChange	number	Difference in percentage between last year last close and current price	13.4271
day_high	number	Highest value of the day	4460.000000000000
day_low	number	Lowest value of the day	4410.000000000000
Yesterday	number	Yesterday close	4443.000000000000
LastWeek	number	Last week close	4379.000000000000
LastMonth	number	Last month close	4574.000000000000
LastYear	number	Last year close	4450.000000000000
StartYear	number	Start year close	3910.000000000000
ISIN	string	ISIN code	“US0378331005”
Unit	string	Unit of the value	“CNY/T”
Frequency	string	Market frequency	“Daily”
LastUpdate	string	Time when new data was inserted or changed	“2023-04-13T18:24:00”