Earnings Revenues

The API also provides historical of stocks earnings and fundamental information. Category is always a required parameter.

Default calendar

Get default earnings revenues calendar

/earnings-revenues

te.getEarnings()

data = te.getEarnings().then(function(data){
  console.log(data)     
});

WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/earnings-revenues?c=guest:guest");

By date

Get earnings revenues calendar by date

/earnings-revenues?d1=yyyy-mm-dd

te.getEarnings(initDate='2017-01-01', output_type = 'df')

data = te.getEarnings(start_date = '2017-01-01').then(function(data){
  console.log(data)     
});

WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/earnings-revenues?c=guest:guest&d1=2017-01-01");

/earnings-revenues?d1=yyyy-mm-dd&d2=yyy-mm-dd

te.getEarnings(initDate='2017-01-01', endDate='2017-12-31', output_type = 'df')

data = te.getEarnings(start_date = '2017-01-01', end_date = '2017-12-31').then(function(data){
  console.log(data)     
});

WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/earnings-revenues?c=guest:guest&d1=2017-01-01&d2=2017-12-31");

By symbol and date

Get earnings revenues calendar by instrument symbol and date

/earnings-revenues/symbol/{symbol}?d1=yyyy-mm-dd

te.getEarnings(symbols = 'aapl:us', initDate='2017-01-01', output_type = 'df')

data = te.getEarnings(symbol = 'aapl:us', start_date = '2017-01-01').then(function(data){
  console.log(data)     
});

WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/earnings-revenues/symbol/aapl:us?c=guest:guest&d1=2017-01-01");

/earnings-revenues/symbol/{symbol}?d1=yyyy-mm-dd&d2=yyyy-mm-dd

te.getEarnings(symbols = 'aapl:us', initDate='2016-01-01',
 endDate='2017-12-31', output_type = 'df')

data = te.getEarnings(symbol = 'aapl:us', start_date = '2016-01-01',
 end_date = '2017-12-31').then(function(data){
  console.log(data)     
});

WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/earnings-revenues/symbol/aapl:us?c=guest:guest&d1=2016-01-01&d2=2017-12-31");

By country

Get earnings revenues calendar by country

/earnings-revenues/country/{country}

te.getEarnings(country = 'mexico', output_type = 'df')

data = te.getEarnings(country = 'mexico').then(function(data){
  console.log(data)     
});

WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/earnings-revenues/country/mexico?c=guest:guest");

By country and date

Get earnings revenues calendar by country and date

/earnings-revenues/country/{country}?d1=yyyy-mm-dd&d2=yyyy-mm-dd

te.getEarnings(country = 'mexico', initDate='2016-01-01',
 endDate='2023-12-31', output_type = 'df')

data = te.getEarnings(country = 'mexico', start_date = '2016-01-01',
 end_date = '2023-12-31').then(function(data){
  console.log(data)     
});

WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/earnings-revenues/country/mexico?d1=2016-01-01&d2=2023-12-31&c=guest:guest");

Response fields

Field	Type	Description	Example
Date	string	Release date in UTC	“2023-03-15”
Symbol	string	Unique symbol used by Trading Economics	“ADBE:US”
Name	string	Company name	“Adobe Systems”
Actual	string	Earnings per share	“3.80”
Forecast	string	Average forecast among a representative group of analysts	“3.68”
Previous	string	Previously released value	“3.37”
Revenue	string	Revenue value	“4.66B”
RevenueForecast	string	Forecast revenue value	“4.62B”
RevenuePrevious	string	Previous revenue value	“4.26B”
MarketCapUSD	number	Market cap in US dollar	173177600000
FiscalTag	string	Fiscal year and quarter	“FY2023Q1”
FiscalReference	string	Fiscal year and quarter in different format	“Q1”
CalendarReference	string	Calendar quarter for the release	“2022-12-31”
Country	string	Country name	“United States”
Currency	string	Currency	“USD”
Importance	number	1 = low, 2 = medium, 3 = high	3
Session	number	Expected earnings release hour	21
marketRelease	string	Release type: after_close, before_open, by_day_end	“after_close”
LastUpdate	string	Time when new data was inserted or changed	“2023-03-18T16:15:00”