Skip to main content
GET
Historical Ticker Earnings

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

ticker
string
required

A single ticker

Example:

"AAPL"

Response

The earnings data for a ticker and date.

actual_eps
string
Example:

"1.44"

ending_fiscal_quarter
string

An ISO date.

Example:

"2024-01-09T00:00:00.000Z"

expected_move
string

The expected earnings move in $.

Example:

"1.23"

expected_move_perc
string

The expected earnings move in %.

Example:

"0.08"

long_straddle_1d
string

The 1 day % returns for the closest expiry long ATM straddle. The straddle expiry is equal to or greater than 1 day after earnings.

Example:

"0.3421"

long_straddle_1w
string

The 1 week % returns for the closest expiry long ATM straddle. The straddle expiry is equal to or greater than 1 week after earnings.

Example:

"0.3421"

post_earnings_move_1d
string

The 1 day % move after the earnings report.

Example:

"0.08"

post_earnings_move_1w
string

The 1 week % move after the earnings report.

Example:

"0.08"

post_earnings_move_2w
string

The 2 week % move after the earnings report.

Example:

"0.08"

post_earnings_move_3d
string

The 3 day % move after the earnings report.

Example:

"0.08"

pre_earnings_move_1d
string

The 1 day % move up to the earnings report.

Example:

"0.08"

pre_earnings_move_1w
string

The 1 week % move up to the earnings report.

Example:

"0.08"

pre_earnings_move_2w
string

The 2 week % move up to the earnings report.

Example:

"0.08"

pre_earnings_move_3d
string

The 3 day % move up to the earnings report.

Example:

"0.08"

report_date
string

An ISO date.

Example:

"2024-01-09T00:00:00.000Z"

report_time
string

The earnings report time. Possible values include: premarket, postmarket and unknown

Example:

"postmarket"

short_straddle_1d
string

The 1 day % returns for the closest expiry short ATM straddle. The straddle expiry is equal to or greater than 1 day after earnings.

Example:

"0.3421"

short_straddle_1w
string

The 1 week % returns for the closest expiry short ATM straddle. The straddle expiry is equal to or greater than 1 week after earnings.

Example:

"0.3421"

source
string

The source of the report date. Either the report date comes from the company or it is an estimation. Possible values: company, estimation.

Example:

"company"

street_mean_est
string

The Street mean EPS estimates.

Example:

"1.34"

Last modified on September 29, 2026