Not familiar with our API? checkout our getting started page .

Zacks EPS Surprises Python 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:

get_zacks_eps_surprises()

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
from __future__ import print_function
import time
import intrinio_sdk as intrinio
from intrinio_sdk.rest import ApiException
intrinio.ApiClient().set_api_key('YOUR_API_KEY')
intrinio.ApiClient().allow_retries(True)
start_date = ''
end_date = ''
eps_actual_greater = ''
eps_actual_less = ''
eps_mean_estimate_greater = ''
eps_mean_estimate_less = ''
eps_amount_diff_greater = ''
eps_amount_diff_less = ''
eps_percent_diff_greater = ''
eps_percent_diff_less = ''
eps_count_estimate_greater = ''
eps_count_estimate_less = ''
eps_std_dev_estimate_greater = ''
eps_std_dev_estimate_less = ''
page_size = 100
next_page = ''
response = intrinio.ZacksApi().get_zacks_eps_surprises(start_date=start_date, end_date=end_date, eps_actual_greater=eps_actual_greater, 
  eps_actual_less=eps_actual_less, eps_mean_estimate_greater=eps_mean_estimate_greater, eps_mean_estimate_less=eps_mean_estimate_less, 
  eps_amount_diff_greater=eps_amount_diff_greater, eps_amount_diff_less=eps_amount_diff_less, eps_percent_diff_greater=eps_percent_diff_greater, 
  eps_percent_diff_less=eps_percent_diff_less, eps_count_estimate_greater=eps_count_estimate_greater, eps_count_estimate_less=eps_count_estimate_less, 
  eps_std_dev_estimate_greater=eps_std_dev_estimate_greater, eps_std_dev_estimate_less=eps_std_dev_estimate_less, page_size=page_size, next_page
  =next_page)
print(response)
    
הההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההה
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Parameters

Name	Type	Description	Notes
start_date	date	Limit EPS surprises to those on or after this date	[optional]
end_date	date	Limit EPS surprises to those on or before this date	[optional]
eps_actual_greater	float	Return only records with an actual EPS higher than this value	[optional]
eps_actual_less	float	Return only records with an actual EPS lower than this value	[optional]
eps_mean_estimate_greater	float	Return only records with an EPS mean estimate greater than this value	[optional]
eps_mean_estimate_less	float	Return only records with an EPS mean estimate lower than this value	[optional]
eps_amount_diff_greater	float	Return only records with an EPS amount difference greater than this value	[optional]
eps_amount_diff_less	float	Return only records with an EPS amount difference less than this value	[optional]
eps_percent_diff_greater	float	Return only records with an EPS percent difference greater than this value	[optional]
eps_percent_diff_less	float	Return only records with an EPS percent difference less than this value	[optional]
eps_count_estimate_greater	float	Return only records with an EPS count estimate greater than this value	[optional]
eps_count_estimate_less	float	Return only records with an EPS count estimate less than this value	[optional]
eps_std_dev_estimate_greater	float	Return only records with an EPS standard deviation greater than this value	[optional]
eps_std_dev_estimate_less	float	Return only records with an EPS standard deviation less than this value	[optional]
page_size	int	The number of results to return	[optional] [default to 100]
next_page	str	Gets the next page of data from a previous API call	[optional]

Return Type

object

ApiResponseZacksEPSSurprises

Properties

Name	Type	Description
eps_surprises	list[ZacksEPSSurprise]	Zacks EPS Surprise data for a Security in descending order by actual reported date
next_page	str	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	str	The Intrinio ID for the record
fiscal_year	float	The company's fiscal year for the reported period
fiscal_quarter	str	The company's fiscal quarter for the reported period
calendar_year	float	The closest calendar year for the company's fiscal year
calendar_quarter	str	The closest calendar quarter for the company's fiscal year
actual_reported_date	date	The actual report date for the earnings release
actual_reported_time	str	The actual report time for the earnings release
actual_reported_code	str	The code cooresponding to the earnings release BTO = BEFORE THE OPEN	DTM = DURING THE MARKET	AMC = AFTER MARKET CLOSE
actual_reported_desc	str	The description for the type of earnings release
eps_actual	float	The actual Non-GAAP EPS figure released by the company, interpreted by Zacks.
eps_actual_zacks_adj	float	The adjustments Zacks made to get to Non-GAAP EPS to reconcile with GAAP EPS.
eps_mean_estimate	float	The pre-earnings release mean EPS estimate for the company
eps_amount_diff	float	The EPS surprise amount difference
eps_percent_diff	float	The EPS surprise percent difference
eps_count_estimate	float	The pre-earnings release number of estimates by analysts
eps_std_dev_estimate	float	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	str	The Intrinio ID for Security
company_id	str	The Intrinio ID for the Company for which the Security is issued
exchange	str	The exchange's MIC
exchange_mic	str	The security's exchange MIC
stock_exchange_id	str	The exchange's Intrinio ID
name	str	The name of the Security
code	str	A 2-3 digit code classifying the Security (reference)
currency	str	The currency in which the Security is traded on the exchange
ticker	str	The common/local ticker of the Security
composite_ticker	str	The country-composite ticker of the Security
figi	str	The OpenFIGI identifier
composite_figi	str	The country-composite OpenFIGI identifier
share_class_figi	str	The global-composite OpenFIGI identifier
primary_listing	bool	If True, the Security is the primary issue for the company, otherwise it is a secondary issue on a secondary stock exchange

SDKs

C# SDK

Java SDK

JavaScript SDK

Python SDK

R SDK

Ruby SDK

EPS Surprises - API Endpoints

Zacks EPS Surprises

Zacks EPS Surprises for Security

Zacks EPS Surprises Python API Documentation

Stock Price Code Example

Parameters

Return Type

Properties

Properties

Properties