Analyst Financial Estimates

GET /api/v1.0/quote/{symbol}/financials/estimate

Get multi-period historical and future analyst consensus financial estimates (EPS_GAAP, REVENUE, EBIT, NET_INCOME_GAAP) and actual values for a stock.

Request

Parameter	Type	In	Required	Description
symbol	string	path	yes	Stock symbol (path param), e.g. US.AAPL / US.TSLA / HK.00700
estimate_type	string	query	no	Estimate metric type: EPS_GAAP (default) / REVENUE / EBIT / NET_INCOME_GAAP
period_type	string	query	no	Estimate period type: AUTO (default) / QUARTERLY / SEMI_ANNUAL / ANNUAL
hist_count	int	query	no	Number of historical periods to return, default 8, max 20
fut_count	int	query	no	Number of future periods to return, default 4, max 20

Example

curl -X GET 'https://webapi.moomoo.com/api/v1.0/quote/US.AAPL/financials/estimate?estimate_type=1&period_type=1&hist_count=1' \
  -H 'Authorization: Bearer <AccessToken>' | jq

Response

Field	Type	Description
data.period_type	integer	Actual estimate period type returned
data.currency	string	Currency unit, e.g. USD / HKD / CNY
data.historical_estimates	object	Historical periods consensus forecast vs actuals
data.historical_estimates[].fiscal_year	integer	Fiscal year
data.historical_estimates[].fiscal_quarter	integer	Fiscal quarter (1~4)
data.historical_estimates[].period_str	string	Period text, e.g. '2025/Q4' / '2025/FY'
data.historical_estimates[].actual_value	string	Actual reported value
data.historical_estimates[].consensus_mean	string	Analyst consensus mean forecast
data.historical_estimates[].num_analysts	integer	Number of analysts contributing to consensus
data.historical_estimates[].currency	string	Currency unit
data.future_estimates	object	Future periods consensus forecast list
data.future_estimates[].fiscal_year	integer	Fiscal year
data.future_estimates[].fiscal_quarter	integer	Fiscal quarter (1~4)
data.future_estimates[].period_str	string	Period text, e.g. '2025/Q4' / '2025/FY'
data.future_estimates[].actual_value	string	Actual reported value
data.future_estimates[].consensus_mean	string	Analyst consensus mean forecast
data.future_estimates[].num_analysts	integer	Number of analysts contributing to consensus
data.future_estimates[].currency	string	Currency unit

Errors

ret_code	error.code	Description
0	—	Success
-3	invalid_parameter	Missing or invalid parameter
-7	invalid_symbol	Unknown symbol
-8	unsupported	Market or product is not supported
-9	permission_denied	Missing permission
-10	no_data	No data
-11	rate_limited	Too many requests

Sample

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "period_type": 0,
    "currency": "example",
    "historical_estimates": "example",
    "future_estimates": "example"
  }
}