Zacks EPS Surprises Java API Documentation

This database returns historical estimated and actual earnings, guidance, and announcement dates for 17,000+ US and Canadian listed companies.

API Class:

ZacksApi

Instance Method:

getZacksEpsSurprises()

Stock Price Code Example

Use my API Key

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
import com.intrinio.api.*;
import com.intrinio.models.*;
import com.intrinio.invoker.*;
import com.intrinio.invoker.auth.*;
import org.threeten.bp.*;
import java.math.BigDecimal;
import java.util.*;
public class Main {
  public static void main(String[] args) throws Exception {
    ApiClient defaultClient = Configuration.getDefaultApiClient();
    ApiKeyAuth auth = (ApiKeyAuth) defaultClient.getAuthentication("ApiKeyAuth");
    auth.setApiKey("YOUR_API_KEY");
    defaultClient.setAllowRetries(true);
    ZacksApi zacksApi = new ZacksApi();
    LocalDate startDate = null;
    LocalDate endDate = null;
    BigDecimal epsActualGreater = null;
    BigDecimal epsActualLess = null;
    BigDecimal epsMeanEstimateGreater = null;
    BigDecimal epsMeanEstimateLess = null;
    BigDecimal epsAmountDiffGreater = null;
    BigDecimal epsAmountDiffLess = null;
    BigDecimal epsPercentDiffGreater = null;
    BigDecimal epsPercentDiffLess = null;
    BigDecimal epsCountEstimateGreater = null;
    BigDecimal epsCountEstimateLess = null;
    BigDecimal epsStdDevEstimateGreater = null;
    BigDecimal epsStdDevEstimateLess = null;
    Integer pageSize = 100;
    String nextPage = null;
    ApiResponseZacksEPSSurprises result = zacksApi.getZacksEpsSurprises(startDate, endDate, epsActualGreater, epsActualLess, epsMeanEstimateGreater, 
      epsMeanEstimateLess, epsAmountDiffGreater, epsAmountDiffLess, epsPercentDiffGreater, epsPercentDiffLess, epsCountEstimateGreater, 
      epsCountEstimateLess, epsStdDevEstimateGreater, epsStdDevEstimateLess, pageSize, nextPage);
    System.out.println(result);
  }
}
הההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההה
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Parameters

Name	Type	Description	Notes
startDate	LocalDate	Limit EPS surprises to those on or after this date	[optional]
endDate	LocalDate	Limit EPS surprises to those on or before this date	[optional]
epsActualGreater	BigDecimal	Return only records with an actual EPS higher than this value	[optional]
epsActualLess	BigDecimal	Return only records with an actual EPS lower than this value	[optional]
epsMeanEstimateGreater	BigDecimal	Return only records with an EPS mean estimate greater than this value	[optional]
epsMeanEstimateLess	BigDecimal	Return only records with an EPS mean estimate lower than this value	[optional]
epsAmountDiffGreater	BigDecimal	Return only records with an EPS amount difference greater than this value	[optional]
epsAmountDiffLess	BigDecimal	Return only records with an EPS amount difference less than this value	[optional]
epsPercentDiffGreater	BigDecimal	Return only records with an EPS percent difference greater than this value	[optional]
epsPercentDiffLess	BigDecimal	Return only records with an EPS percent difference less than this value	[optional]
epsCountEstimateGreater	BigDecimal	Return only records with an EPS count estimate greater than this value	[optional]
epsCountEstimateLess	BigDecimal	Return only records with an EPS count estimate less than this value	[optional]
epsStdDevEstimateGreater	BigDecimal	Return only records with an EPS standard deviation greater than this value	[optional]
epsStdDevEstimateLess	BigDecimal	Return only records with an EPS standard deviation less than this value	[optional]
pageSize	Integer	The number of results to return	[optional] [default to 100]
nextPage	String	Gets the next page of data from a previous API call	[optional]

Return Type

object

ApiResponseZacksEPSSurprises

Properties

Name	Type	Description
epsSurprises	List	Zacks EPS Surprise data for a Security in descending order by actual reported date
nextPage	String	The token required to request the next page of the data. If null, no further results are available.

object

ZacksEPSSurprise

Properties

Name	Type	Description
id	String	The Intrinio ID for the record
fiscalYear	BigDecimal	The company's fiscal year for the reported period
fiscalQuarter	String	The company's fiscal quarter for the reported period
calendarYear	BigDecimal	The closest calendar year for the company's fiscal year
calendarQuarter	String	The closest calendar quarter for the company's fiscal year
actualReportedDate	LocalDate	The actual report date for the earnings release
actualReportedTime	String	The actual report time for the earnings release
actualReportedCode	String	The code cooresponding to the earnings release BTO = BEFORE THE OPEN	DTM = DURING THE MARKET	AMC = AFTER MARKET CLOSE
actualReportedDesc	String	The description for the type of earnings release
epsActual	BigDecimal	The actual Non-GAAP EPS figure released by the company, interpreted by Zacks.
epsActualZacksAdj	BigDecimal	The adjustments Zacks made to get to Non-GAAP EPS to reconcile with GAAP EPS.
epsMeanEstimate	BigDecimal	The pre-earnings release mean EPS estimate for the company
epsAmountDiff	BigDecimal	The EPS surprise amount difference
epsPercentDiff	BigDecimal	The EPS surprise percent difference
epsCountEstimate	BigDecimal	The pre-earnings release number of estimates by analysts
epsStdDevEstimate	BigDecimal	The pre-earnings release standard deviation of EPS estimates
security	SecuritySummary	The Security of the Zacks EPS Surprise

object

SecuritySummary

Properties

Name	Type	Description
id	String	The Intrinio ID for Security
companyId	String	The Intrinio ID for the Company for which the Security is issued
exchange	String	The exchange's MIC
exchangeMic	String	The security's exchange MIC
stockExchangeId	String	The exchange's Intrinio ID
name	String	The name of the Security
code	String	A 2-3 digit code classifying the Security (reference)
currency	String	The currency in which the Security is traded on the exchange
ticker	String	The common/local ticker of the Security
compositeTicker	String	The country-composite ticker of the Security
figi	String	The OpenFIGI identifier
compositeFigi	String	The country-composite OpenFIGI identifier
shareClassFigi	String	The global-composite OpenFIGI identifier
primaryListing	Boolean	If true, the Security is the primary issue for the company, otherwise it is a secondary issue on a secondary stock exchange

Zacks EPS Surprises

SDKs

API Endpoints

Standardized & As-Reported Financial Statement Data

Company Reference & Metadata

Company News

Insider & Institutional Holdings Data

Upcoming & Historical IPOs

Raw Text Filings

XBRL Searchable Financial Statement Notes

Aggregate Standardized Financial Statement Data by SIC Codes

Economic Data

Security Reference Data

Real-Time Prices

Historical Intraday Prices

Historical End of Day Prices

Technical Indicators

Historical End of Day Index Prices

Reference & Metadata

Holdings

Returns & Analytics