財報預期對比
GET/api/v1.0/quote/{symbol}/financials/earnings-card獲取指定標的最新一期財報核心指標的實際值 vs 市場一致預期值（Beat / Miss / Meet）對比及 AI 財報亮點總結。 返回包含：財年（fiscal_year）、財報期（period）、發佈時間戳與時段、幣種（currency_code）、財報站跳轉鏈接（scheme）、 核心指標列表（indicator_list，含 OPERATING_REVENUE 營業收入 / BASIC_EPS 基本每股收益 / NET_INCOME 淨利潤 / NET_INCOME_COMMON_SHAREHOLDER 歸普淨利潤的實際值、同比、預期值、預期同比、預期差額、超預期比例與 BEAT/MISS/MEET 標籤）， 以及可選的 AI 財報總結（highlights_content）與 AI 業績洞察（performance_insights）。
請求參數
| 參數 | 類型 | 位置 | 必填 | 說明 |
|---|---|---|---|---|
symbol | string | 路徑 | 是 | 股票代碼（路徑參數），例: US.TSLA / US.AAPL / HK.00700 |
currency_code | string | 查詢 | 否 | 幣種代碼（如 USD / HKD / CNY）；不傳則返回最新財報原始披露幣種 |
請求示例
bash
curl -X GET 'https://webapi.moomoo.com/api/v1.0/quote/US.AAPL/financials/earnings-card?currency_code=1' \
-H 'Authorization: Bearer <AccessToken>' | jq響應參數
| 參數 | 類型 | 說明 |
|---|---|---|
data.fiscal_year | integer | 財年，例: 2026 |
data.period | integer | 財報週期：Q1 / Q2 / Q3 / Q4 / H1 / Q9 / FY |
data.currency_code | string | 披露幣種代碼，例: USD |
data.publish_time | integer | 財報發佈時間（Unix 毫秒時間戳） |
data.publish_type | integer | 發佈時段：PRE_MARKET=盤前 / AFTER_HOURS=盤後 / REGULAR=當天 |
data.scheme | string | 財報站詳情鏈接 |
data.highlights_content | string | AI 財報總結文本 |
data.performance_insights | string | AI 業績洞察要點列表 |
data.indicators | object | 核心財務指標實際值與一致預期對比列表 |
data.indicators[].indicator_type | integer | 指標類型：OPERATING_REVENUE=營業收入 / BASIC_EPS=基本每股收益 / NET_INCOME=淨利潤 / NET_INCOME_COMMON_SHAREHOLDER=歸普淨利潤 |
data.indicators[].actual_value | string | 公佈實際值（原始值已除以 10^4） |
data.indicators[].actual_yoy | string | 實際值同比增速（百分數，19.74 表示 19.74%） |
data.indicators[].predict_value | string | 分析師一致預期值（原始值已除以 10^4） |
data.indicators[].predict_yoy | string | 一致預期同比增速（百分數） |
data.indicators[].last_year_actual_value | string | 去年同期實際值（原始值已除以 10^4） |
data.indicators[].surprise_diff | string | 實際值與預期值差額（actual - predict） |
data.indicators[].surprise_pct | number | 超預期/不及預期幅度（百分數，(actual - predict)/ |
data.indicators[].surprise_label | integer | 業績預期達成標籤：BEAT=超預期 / MISS=不及預期 / MEET=符合預期 / NONE=未出或僅預測 |
data.indicators[].is_only_predict | string | 是否尚未公佈實際值（true=僅有預測值） |
錯誤碼
| 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": {
"fiscal_year": 0,
"period": 0,
"currency_code": "example",
"publish_time": 0,
"publish_type": 0,
"scheme": "example",
"highlights_content": "example",
"performance_insights": "example"
}
}