分析师财务预测
GET/api/v1.0/quote/{symbol}/financials/estimate获取个股未来多期与历史各期的分析师一致财务预测（Consensus Mean）及实际公布值对比。 支持切换预测指标类型（estimate_type：EPS_GAAP=每股收益 / REVENUE=总收入 / EBIT=息税前利润 / NET_INCOME_GAAP=净利润）与预测周期（period_type：QUARTERLY=季度 / SEMI_ANNUAL=半年度 / ANNUAL=年度）。 返回包含：historical_estimates（历史各期预测均值 vs 实际值与预测人数）与 future_estimates（未来各期预测均值与预测人数）。
请求参数
| 参数 | 类型 | 位置 | 必填 | 说明 |
|---|---|---|---|---|
symbol | string | 路径 | 是 | 股票代码（路径参数），例: US.AAPL / US.TSLA / HK.00700 |
estimate_type | string | 查询 | 否 | 预测财务指标类型：EPS_GAAP=每股收益（默认）/ REVENUE=总收入 / EBIT=息税前利润 / NET_INCOME_GAAP=净利润 |
period_type | string | 查询 | 否 | 预测周期类型：AUTO=自动按有数据周期返回（默认，单季报>半年报>年报）/ QUARTERLY=季度 / SEMI_ANNUAL=半年度 / ANNUAL=年度 |
hist_count | int | 查询 | 否 | 拉取的历史预测期数，默认 8，最大 20 |
fut_count | int | 查询 | 否 | 拉取的未来预测期数，默认 4，最大 20 |
请求示例
bash
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响应参数
| 参数 | 类型 | 说明 |
|---|---|---|
data.period_type | integer | 实际返回的预测周期类型 |
data.currency | string | 统计货币单位，例: USD / HKD / CNY |
data.historical_estimates | object | 历史各期预测值与实际值列表 |
data.historical_estimates[].fiscal_year | integer | 财年 |
data.historical_estimates[].fiscal_quarter | integer | 财季（1~4） |
data.historical_estimates[].period_str | string | 周期字符串，例: '2025/Q4' / '2025/FY' |
data.historical_estimates[].actual_value | string | 实际值（原始值已除以 10^4） |
data.historical_estimates[].consensus_mean | string | 分析师一致预测均值（原始值已除以 10^4） |
data.historical_estimates[].num_analysts | integer | 参与预测的分析师人数 |
data.historical_estimates[].currency | string | 货币单位 |
data.future_estimates | object | 未来各期分析师一致预测列表 |
data.future_estimates[].fiscal_year | integer | 财年 |
data.future_estimates[].fiscal_quarter | integer | 财季（1~4） |
data.future_estimates[].period_str | string | 周期字符串，例: '2025/Q4' / '2025/FY' |
data.future_estimates[].actual_value | string | 实际值（原始值已除以 10^4） |
data.future_estimates[].consensus_mean | string | 分析师一致预测均值（原始值已除以 10^4） |
data.future_estimates[].num_analysts | integer | 参与预测的分析师人数 |
data.future_estimates[].currency | string | 货币单位 |
错误码
| ret_code | error.code | 说明 |
|---|---|---|
| 0 | — | 成功 |
| -3 | invalid_parameter | 参数缺失或不在允许范围内 |
| -7 | invalid_symbol | 标的不存在 |
| -8 | unsupported | 市场或品类不支持 |
| -9 | permission_denied | 没有对应权限 |
| -10 | no_data | 没有可返回的数据 |
| -11 | rate_limited | 调用过于频繁 |
响应示例
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"period_type": 0,
"currency": "example",
"historical_estimates": "example",
"future_estimates": "example"
}
}