分析師財務預測
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"
}
}