Skip to content
Financials and Earnings

Get latest earnings versus estimates

Query the actual revenue, EBIT, and EPS of the security's latest earnings report under the specified report period type, compared with market consensus estimates, together with the estimates and expected release date of the next report. Used for the latest earnings card on the stock Financials page.

  • revenue, ebit, and eps each give the estimate, the actual value, their difference, and year-over-year changes; compare and desc describe the result.
  • upcoming contains the consensus estimates and expected release time of the next report.
  • When the user switches the report period type, query again with a value from opt_reports as report. Call GET /v1/stock-info/financial-consensus-detail to view all historical comparisons.
GEThttps://api.lbkrs.com/v2/stock-info/latest-fin-view

Parameters

counter_idstringqueryRequired

Security code, such as ST/US/AAPL

reportstringquery

Report period type. Uses the server default when omitted:

  • af - Annual report
  • saf - Semi-annual report
  • qf - Single-quarter report

Responses

HTTP 200The request succeeded. The response body contains the result of the “Get latest earnings versus estimates” operation.
Standard response envelopecodemessagedata
dataobjectdata structure
reportstring

Report period type of this result:

  • af - Annual report
  • saf - Semi-annual report
  • qf - Quarterly report
report_titlestring

Report period title, such as “FY2026 Q3 Earnings”

fiscal_yearinteger

Fiscal year

fiscal_periodstring

Fiscal period number

fp_startstring

Start date of the report period, in YYYY.MM.DD format

fp_endstring

End date of the report period, in YYYY.MM.DD format

currencystring

Currency of the amounts, such as USD

revenueobject

Actual value of an earnings metric compared with the consensus estimate

Child attributes
eststring

Consensus estimate

actualstring

Actual value; empty before results are released

value_vsstring

Actual value minus the estimate

est_yoystring

Year-over-year change of the estimate, as a percentage number; for example, 15.87 means 15.87%

actual_yoystring

Year-over-year change of the actual value, as a percentage number

yoy_vsstring

Actual year-over-year change minus the estimated year-over-year change, in percentage points

descstring

Comparison result text, such as “Beat estimates”

comparestring

Comparison result code:

  • beat_est - Beat estimates
  • met_est - Met estimates
  • miss_est - Missed estimates
ebitobject

Actual value of an earnings metric compared with the consensus estimate

Child attributes
eststring

Consensus estimate

actualstring

Actual value; empty before results are released

value_vsstring

Actual value minus the estimate

est_yoystring

Year-over-year change of the estimate, as a percentage number; for example, 15.87 means 15.87%

actual_yoystring

Year-over-year change of the actual value, as a percentage number

yoy_vsstring

Actual year-over-year change minus the estimated year-over-year change, in percentage points

descstring

Comparison result text, such as “Beat estimates”

comparestring

Comparison result code:

  • beat_est - Beat estimates
  • met_est - Met estimates
  • miss_est - Missed estimates
epsobject

Actual value of an earnings metric compared with the consensus estimate

Child attributes
eststring

Consensus estimate

actualstring

Actual value; empty before results are released

value_vsstring

Actual value minus the estimate

est_yoystring

Year-over-year change of the estimate, as a percentage number; for example, 15.87 means 15.87%

actual_yoystring

Year-over-year change of the actual value, as a percentage number

yoy_vsstring

Actual year-over-year change minus the estimated year-over-year change, in percentage points

descstring

Comparison result text, such as “Beat estimates”

comparestring

Comparison result code:

  • beat_est - Beat estimates
  • met_est - Met estimates
  • miss_est - Missed estimates
upcomingobject

Estimates and release date of the next earnings report

Child attributes
est_epsstring

Consensus EPS estimate for the next report

est_ebitstring

Consensus EBIT estimate for the next report

est_revenuestring

Consensus revenue estimate for the next report

rpt_datestring

Display text of the expected release date, such as “Nov 2, 2026”

rpt_timestampstring

Expected release time as a Unix timestamp in seconds

reportstring

Report period type of the next report

fiscal_yearinteger

Fiscal year of the next report

fiscal_periodstring

Fiscal period number of the next report

report_descstring

Summary text of the report

opt_reportsarray<string>

Available report period types, using the report values

Whale Docs