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

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

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

data = te.getEarnings().then(function(data){
  console.log(data)     
});
WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/earnings-revenues?c=guest:guest");
DateSymbolNameActualActualValueForecastForecastValuePreviousPreviousValueRevenueRevenueValueRevenueForecastRevenueForecastValueRevenuePreviousRevenuePreviousValueMarketCapUSDFiscalTagFiscalReferenceCalendarReferenceCountryCurrencyImportanceSessionMarketReleaseLastUpdate
2023-06-13AHT:LNAshtead0.840.8430626778072FY2023Q4Q42023-03-31United KingdomGBp124by_day_end6/20/2023 7:24:00 PM
2023-06-13MDI:CNMajor Drilling0.250.250.260.260.270.27184.97M184970000192.04M192040000189.98M189980000586712712FY2023Q4Q42023-03-31CanadaCAD121after_close6/17/2023 8:10:00 AM
2023-06-14ADBE:USAdobe Systems3.353.354.39B4390000000237552100000FY2023Q2Q22023-03-31United StatesUSD321after_close4/21/2023 6:57:00 PM

By date

Get earnings revenues calendar by date

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

te.getEarnings(initDate='2017-01-01')
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");
DateSymbolNameActualActualValueForecastForecastValuePreviousPreviousValueRevenueRevenueValueRevenueForecastRevenueForecastValueRevenuePreviousRevenuePreviousValueMarketCapUSDFiscalTagFiscalReferenceCalendarReferenceCountryCurrencyImportanceSessionMarketReleaseLastUpdate
2017-01-04RECN:USResources Connection0.180.180.190.190.160.16560700000FY2017Q3Q32016-12-31United StatesUSD121after_close12/11/2022 7:05:00 PM
2017-01-05WBA:USWalgreens Boots Alliance1.11.11.311.3126498900000FY2017Q2Q22016-12-31United StatesUSD313before_open12/11/2022 1:03:00 PM
2017-01-05STZ:USConstellation Brands1.961.961.71.71.191.1948122900000FY2017Q4Q42016-12-31United StatesUSD213before_open12/12/2022 3:25:00 AM

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

te.getEarnings(initDate='2017-01-01', endDate='2017-12-31')
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");
DateSymbolNameActualActualValueForecastForecastValuePreviousPreviousValueRevenueRevenueValueRevenueForecastRevenueForecastValueRevenuePreviousRevenuePreviousValueMarketCapUSDFiscalTagFiscalReferenceCalendarReferenceCountryCurrencyImportanceSessionMarketReleaseLastUpdate
2017-01-04RECN:USResources Connection0.180.180.190.190.160.16560700000FY2017Q3Q32016-12-31United StatesUSD121after_close12/11/2022 7:05:00 PM
2017-01-05WBA:USWalgreens Boots Alliance1.11.11.311.3126498900000FY2017Q2Q22016-12-31United StatesUSD313before_open12/11/2022 1:03:00 PM
2017-01-05STZ:USConstellation Brands1.961.961.71.71.191.1948122900000FY2017Q4Q42016-12-31United StatesUSD213before_open12/12/2022 3:25:00 AM

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')
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");
DateSymbolNameActualActualValueForecastForecastValuePreviousPreviousValueRevenueRevenueValueRevenueForecastRevenueForecastValueRevenuePreviousRevenuePreviousValueMarketCapUSDFiscalTagFiscalReferenceCalendarReferenceCountryCurrencyImportanceSessionMarketReleaseLastUpdate
2017-01-31AAPL:USApple3.363.360.820.8278.35B7835000000075.87B758700000003093777000000FY2017Q1Q12016-12-31United StatesUSD313before_open12/12/2022 5:42:00 AM
2017-05-02AAPL:USApple2.12.10.480.4852.90B5290000000050.56B505600000003093777000000FY2017Q2Q22017-03-31United StatesUSD313before_open12/12/2022 5:42:00 AM
2017-08-01AAPL:USApple1.671.670.360.3645.41B4541000000042.36B423600000003093777000000FY2017Q3Q32017-06-30United StatesUSD313before_open12/12/2022 5:42:00 AM

/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')
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");
DateSymbolNameActualActualValueForecastForecastValuePreviousPreviousValueRevenueRevenueValueRevenueForecastRevenueForecastValueRevenuePreviousRevenuePreviousValueMarketCapUSDFiscalTagFiscalReferenceCalendarReferenceCountryCurrencyImportanceSessionMarketReleaseLastUpdate
2016-01-26AAPL:USApple3.283.280.770.7775.87B7587000000074.60B746000000003093777000000FY2016Q1Q12015-12-31United StatesUSD321after_close12/12/2022 5:42:00 AM
2016-04-26AAPL:USApple1.91.90.580.5850.56B5056000000058.01B580100000003093777000000FY2016Q2Q22016-03-31United StatesUSD321after_close12/12/2022 5:42:00 AM
2016-07-26AAPL:USApple1.421.420.460.4642.36B4236000000049.61B496100000003093777000000FY2016Q3Q32016-06-30United StatesUSD321after_close12/12/2022 5:42:00 AM

By country

Get earnings revenues calendar by country

/earnings-revenues/country/{country}

te.getEarnings(country = 'mexico')
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");
DateSymbolNameActualActualValueForecastForecastValuePreviousPreviousValueRevenueRevenueValueRevenueForecastRevenueForecastValueRevenuePreviousRevenuePreviousValueMarketCapUSDFiscalTagFiscalReferenceCalendarReferenceCountryCurrencyImportanceSessionMarketReleaseLastUpdate
2023-07-10TV:USGrupo Televisa Sab0.040.040.060.061.05B1050000000923.00M9230000002822900000FY2023Q2Q22023-06-30MexicoUSD121after_close7/7/2023 8:46:00 PM
2023-07-18ALFAA:MMAlfa0.990.9996.87B968700000002938204886FY2023Q2Q22023-06-30MexicoMXN124by_day_end5/26/2023 10:56:00 AM
2023-07-18ALPEKA:MMAlpek0.140.1456.40B564000000002171026546FY2023Q2Q22023-06-30MexicoMXN124by_day_end5/26/2023 10:55:00 AM

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')
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");
DateSymbolNameActualActualValueForecastForecastValuePreviousPreviousValueRevenueRevenueValueRevenueForecastRevenueForecastValueRevenuePreviousRevenuePreviousValueMarketCapUSDFiscalTagFiscalReferenceCalendarReferenceCountryCurrencyImportanceSessionMarketReleaseLastUpdate
2016-02-23KOF:USFEMSA0.950.951.061.0617280900000FY2015Q4Q42015-12-31MexicoMXN121after_close12/11/2022 11:24:00 PM
2016-02-29SIM:USGrupo Simec Sab De Cv2.042.040.040.0417404900000FY2015Q4Q42015-12-31MexicoMXN121after_close12/12/2022 3:26:00 AM
2016-03-31AC:MMArca Continental4.804.80.810.8121.27B2127000000015.27B1527000000017871365894FY2016Q1Q12016-03-31MexicoMXN2by_day_end1/21/2023 10:47:00 AM

By index

Get earnings revenues calendar by index

/earnings-revenues/index/{index}

te.getEarnings(index = 'ndx:ind')
data = te.getEarnings(index = 'ndx:ind').then(function(data){
  console.log(data)     
});
WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/earnings-revenues/index/ndx:ind?c=guest:guest");
DateSymbolNameActualActualValueForecastForecastValuePreviousPreviousValueRevenueRevenueValueRevenueForecastRevenueForecastValueRevenuePreviousRevenuePreviousValueMarketCapUSDFiscalTagFiscalReferenceCalendarReferenceCountryCurrencyImportanceSessionMarketReleaseLastUpdate
2023-06-14ADBE:USAdobe Systems3.353.354.39B4390000000237552100000FY2023Q2Q22023-03-31United StatesUSD321after_close4/21/2023 6:57:00 PM
2023-06-15ADBE:USAdobe Systems3.913.913.793.793.353.354.82B48200000004.77B47700000004.39B4390000000237552100000FY2023Q2Q22023-03-31United StatesUSD321after_close6/15/2023 8:30:00 PM
2023-06-27WBA:USWalgreens Boots Alliance1.0011.081.0835.4B3540000000034.24B3424000000026498900000FY2023Q3Q32023-03-31United StatesUSD213before_open7/1/2023 12:10:00 AM

By index and date

Get earnings revenues calendar by index and date

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

te.getEarnings(index = 'ndx:ind', initDate='2016-01-01', endDate='2023-12-31')
data = te.getEarnings(index = 'ndx:ind', 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/index/ndx:ind?d1=2016-01-01&d2=2023-12-31&c=guest:guest");
DateSymbolNameActualActualValueForecastForecastValuePreviousPreviousValueRevenueRevenueValueRevenueForecastRevenueForecastValueRevenuePreviousRevenuePreviousValueMarketCapUSDFiscalTagFiscalReferenceCalendarReferenceCountryCurrencyImportanceSessionMarketReleaseLastUpdate
2016-01-07WBA:USWalgreens Boots Alliance1.031.031.181.1826498900000FY2016Q2Q22015-12-31United StatesUSD321after_close12/11/2022 1:03:00 PM
2016-01-12CSX:USCSX0.480.480.160.1669049300000FY2015Q4Q42015-12-31United StatesUSD321after_close12/12/2022 1:16:00 AM
2016-01-14INTC:USIntel0.740.740.740.74139970900000FY2015Q4Q42015-12-31United StatesUSD321after_close12/11/2022 8:32:00 PM

List of stock sectors

Get a list of possible stock sectors

/sectors

te.getSectors()
data = te.getSectors().then(function(data){
  console.log(data)     
});
WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/sectors?c=guest:guest");
Sector
Communication Services
Communications
Consumer Discretionary

By sector

Get earnings revenues calendar by sector

/earnings-revenues/sector/{sector}

te.getEarnings(sector = 'materials')
data = te.getEarnings(sector = 'materials').then(function(data){
  console.log(data)     
});
WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/earnings-revenues/sector/materials?c=guest:guest");
DateSymbolNameActualActualValueForecastForecastValuePreviousPreviousValueRevenueRevenueValueRevenueForecastRevenueForecastValueRevenuePreviousRevenuePreviousValueMarketCapUSDFiscalTagFiscalReferenceCalendarReferenceCountryCurrencyImportanceSessionMarketReleaseLastUpdate
2023-06-13MDI:CNMajor Drilling0.250.250.260.260.270.27184.97M184970000192.04M192040000189.98M189980000586712712FY2023Q4Q42023-03-31CanadaCAD121after_close6/17/2023 8:10:00 AM
2023-06-22CMC:USCommercial Metals2.022.021.831.832.612.612.34B23400000002.33B23300000002.52B25200000006623500000FY2023Q3Q32023-03-31United StatesUSD113before_open6/22/2023 9:01:00 PM
2023-06-225714:JPDowa219.54219.54209.93B2099300000001978619640FY2024Q1Q12023-06-30JapanJPY14after_close4/21/2023 6:58:00 PM

By sector and date

Get earnings revenues calendar by sector and date

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

te.getEarnings(sector = 'materials', initDate='2016-01-01', endDate='2023-12-31')
data = te.getEarnings(sector = 'materials', 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/sector/materials?d1=2016-01-01&d2=2023-12-31&c=guest:guest");
DateSymbolNameActualActualValueForecastForecastValuePreviousPreviousValueRevenueRevenueValueRevenueForecastRevenueForecastValueRevenuePreviousRevenuePreviousValueMarketCapUSDFiscalTagFiscalReferenceCalendarReferenceCountryCurrencyImportanceSessionMarketReleaseLastUpdate
2016-01-06RPM:USRpm International0.140.140.200.211812500000FY2016Q3Q32015-12-31United StatesUSD221after_close12/11/2022 6:55:00 PM
2016-01-07SCHN:USSchnitzer Steel Industries-0.13-0.13-0.43-0.43870700000FY2016Q2Q22015-12-31United StatesUSD121after_close12/11/2022 6:42:00 PM
2016-01-07WDFC:USWd 400.830.830.760.763152200000FY2016Q2Q22015-12-31United StatesUSD121after_close12/11/2022 3:10:00 PM

Response fields

FieldTypeDescriptionExample
DatestringRelease date in UTC“2023-03-15”
SymbolstringUnique symbol used by Trading Economics“ADBE:US”
NamestringCompany name“Adobe Systems”
ActualstringEarnings per share“3.80”
ActualValuenumberEarnings per share value3.80
ForecaststringAverage forecast among a representative group of analysts“3.68”
ForecastValuenumberAverage numeric forecast among a representative group of analysts3.68
PreviousstringPreviously released value“3.37”
PreviousValuenumberPreviously released numeric value3.37
RevenuestringRevenue value“4.66B”
RevenueValuenumberRevenue numeric value4660000000
RevenueForecaststringForecast revenue value“4.62B”
RevenueForecastValuenumberForecast revenue numeric value4620000000
RevenuePreviousstringPrevious revenue value“4.26B”
RevenuePreviousValuenumberPrevious revenue numeric value4260000000
MarketCapUSDnumberMarket cap in US dollar173177600000
FiscalTagstringFiscal year and quarter“FY2023Q1”
FiscalReferencestringFiscal year and quarter in different format“Q1”
CalendarReferencestringCalendar quarter for the release“2022-12-31”
CountrystringCountry name“United States”
CurrencystringCurrency“USD”
Importancenumber1 = low, 2 = medium, 3 = high3
SessionnumberExpected earnings release hour21
marketReleasestringRelease type: after_close, before_open, by_day_end“after_close”
LastUpdatestringTime when new data was inserted or changed“2023-03-18T16:15:00”

Fields in ‘List of stock sectors’

FieldTypeDescriptionExample
SectorstringSector name“Communication Services”