財報價格走勢

GET /v1/quote/{symbol}/f10/earnings-price-move

獲取股票在財報披露日前後的價格走勢。返回以披露日為中心、跨多個財報期的逐日行情序列（開/收/高/低/昨收/成交量、期權 IV/HV），並附整次請求的 overview 匯總（近 N 個財報期的財報日平均漲跌幅）。

請求參數

參數	類型	位置	必填	說明
`symbol`	string	路徑	是	標的代碼，如 `HK.00700`。
`count`	int	查詢	否	返回最近 N 個財報期的數據。預設 `10`，最大 `50`。
`overview_count`	int	查詢	否	overview 匯總統計的財報期數。預設 `8`，最大 `50`。實際生效值 = min(overview_count, count)。

請求示例

bash

curl "$ip/v1/quote/US.AAPL/f10/earnings-price-move?count=10&overview_count=8" | jq

響應字段

返回 data.records[]（逐日行情）與 data 頂層 overview 匯總字段。

records 字段：

字段	類型	說明
`fiscal_year`	int	財年，如 2025。
`financial_type`	int	財報期類型，詳見命名詞典。
`period_text`	string	財報期文本，如 `2025/Q4`。
`pub_trading_day`	int	披露日交易日時間戳（秒）。
`pub_trading_day_str`	string	披露日字串（yyyy-MM-dd，按市場時區）。
`pub_type`	int	財報披露時點類型，詳見命名詞典。
`price_info_index`	int	披露日在該財報期子數組中的索引位置（即 day_offset=0 處）。
`day_offset`	int	相對披露日的偏移天數（0=披露當日，負=披露前，正=披露後）。
`trading_day`	int	當前行交易日時間戳（秒）。
`trading_day_str`	string	當前行交易日字串（yyyy-MM-dd，按市場時區）。
`open_price`	float	開盤價。
`close_price`	float	收盤價。
`highest_price`	float	最高價。
`lowest_price`	float	最低價。
`last_close_price`	float	昨收價。
`option_iv`	float	期權隱含波動率（%）；無期權數據的標的可能為 0。
`option_hv`	float	期權歷史波動率（%）；無期權數據的標的可能為 0。
`volume`	int	當前行交易日成交量（股）。
`volume_precision`	int	成交量精度 n，真實成交量 = volume / 10^n（通常為 0）。

data 頂層 overview 匯總字段：

字段	類型	說明
`overview_recent_period_count`	int	overview 實際統計的財報期數 N。
`overview_avg_earnings_day_change_pct`	float	近 N 個財報期的財報日平均漲跌幅（%），如 1.15 表示 +1.15%。

限制範圍

支持市場：HK / US / SH / SZ / CA / AU 的正股 / ADR；其它市場正股可能暫無數據（返回空 records）。
僅適用正股類標的；期權 / 期貨 / 外匯 / 指數等非正股品類不支持（返回 unsupported）。
標的合法但無財報行情數據時返回 ret_code=0 + 空 records。

錯誤碼

ret_code	error.code	觸發條件	處理建議
0	—	成功（含合法但無數據，records=[]）	—
-3	invalid_parameter	參數類型/範圍非法（如 count 超 50）	校正參數後重試
-7	invalid_symbol	symbol 解析不到證券	用 search 類接口確認代碼合法性
-8	unsupported	非正股品類（期權/期貨/外匯等）	該接口僅適用正股，換正股代碼
-4 / -6	internal_error	網關內部錯誤	稍後重試；持續失敗聯繫支持

響應示例

json

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "records": [
      {
        "fiscal_year": 2026,
        "financial_type": 1,
        "period_text": "2026/Q1",
        "pub_trading_day": 1769058000,
        "pub_trading_day_str": "2026-01-22",
        "pub_type": 1,
        "price_info_index": 5,
        "day_offset": -1,
        "trading_day": 1768971600,
        "trading_day_str": "2026-01-21",
        "open_price": 248.238789331,
        "close_price": 247.190736542,
        "highest_price": 251.093485501,
        "lowest_price": 244.725317122,
        "last_close_price": 246.242498303,
        "option_iv": 31.095,
        "option_hv": 15.588,
        "volume": 54641725,
        "volume_precision": 0
      },
      {
        "fiscal_year": 2026,
        "financial_type": 1,
        "period_text": "2026/Q1",
        "pub_trading_day": 1769058000,
        "pub_trading_day_str": "2026-01-22",
        "pub_type": 1,
        "price_info_index": 5,
        "day_offset": 0,
        "trading_day": 1769058000,
        "trading_day_str": "2026-01-22",
        "open_price": 248.737862088,
        "close_price": 247.889438401,
        "highest_price": 250.534524014,
        "lowest_price": 247.689809299,
        "last_close_price": 247.190736542,
        "option_iv": 30.057,
        "option_hv": 15.406,
        "volume": 39708340,
        "volume_precision": 0
      }
    ],
    "overview_recent_period_count": 8,
    "overview_avg_earnings_day_change_pct": 1.1529
  }
}

財報價格走勢 ​

請求參數 ​

請求示例 ​

響應字段 ​

限制範圍 ​

錯誤碼 ​

響應示例 ​