財報價格歷史

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

獲取股票在歷次財報披露日及前後偏移日的股價表現。每個財報期返回：期權預期波動率、財報後 IV 收縮、財報對應交易日的 OHLC，以及以披露日為中心 -15 至 +14 天的逐日收盤價序列。

請求參數

參數	類型	位置	必填	說明
symbol	string	路徑	是	標的代碼，如 HK.00700。

請求示例

curl "$ip/v1/quote/HK.00700/f10/earnings-price-history" | jq

響應字段

返回 data.records[]。每個財報期含 30 行（schedule_delta 從 -15 到 +14）。

財報期標識與披露資訊：

字段	類型	說明
fiscal_year	int	財年，如 2025。
financial_type	int	財報期類型代碼，詳見命名詞典。
period_text	string	財報期文本，如 2025/Q4。
is_current	bool	是否當前最新一期。
pub_trading_day	int	披露交易日，毫秒時間戳。
pub_trading_day_str	string	披露交易日字串（yyyy-MM-dd）。
pub_time	int	披露時間，秒級時間戳。
pub_time_str	string	披露時間字串（yyyy-MM-dd HH:mm:ss）。
pub_type	int	披露時點類型，詳見命名詞典。

期權預期波動與 IV 收縮：

字段	類型	說明
predict_vola_ratio_newest	float	最新預期波動率（%）。
predict_vola_ratio_highest	float	最高預期波動率（%）。
predict_vola_val_newest	float	最新預期波動價格（計價貨幣）。
predict_vola_val_highest	float	最高預期波動價格（計價貨幣）。
option_iv_crush	float	財報後 IV 收縮值（百分點）。
option_strike_date_iv_crush	float	財報到期日 IV 收縮值（百分點）。

財報對應交易日行情：

字段	類型	說明
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	昨收價。
volume	int	成交數量（股）。

披露日前後偏移序列：

字段	類型	說明
schedule_delta	int	相對披露日的偏移天數（-15 至 +14；0=披露當日）。
schedule_close_price	float	該偏移日收盤價。

限制範圍

• 市場：僅 HK / US / SH / SZ；其他市場返回 unsupported。
• 品類：僅正股；ETF / 指數 / 窩輪 / 期權等無財報，返回 no_data。
• 支持市場內的正股，若後端暫無該標的財報日股價數據，同樣返回 no_data。

錯誤碼

ret_code	error.code	觸發條件	處理建議
0	—	正常返回	—
-3	invalid_parameter	symbol 格式非法	校正代碼格式後重試
-7	invalid_symbol	symbol 格式合法但查不到對應證券	通過 search 接口確認代碼合法性
-8	unsupported	市場不在 HK / US / SH / SZ 內	僅對支持市場的正股調用
-10	no_data	合法請求但無財報日股價數據	該標的暫無此數據，無需重試
-6	internal_error	網關內部錯誤	重試；持續失敗聯繫服務方

響應示例

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "records": [
      {
        "fiscal_year": 2025,
        "financial_type": 4,
        "period_text": "2025/Q4",
        "is_current": false,
        "pub_trading_day": 1773763200000,
        "pub_trading_day_str": "2026-03-18",
        "pub_time": 1773838800,
        "pub_time_str": "2026-03-18 21:00:00",
        "pub_type": 2,
        "predict_vola_ratio_newest": 3.347,
        "predict_vola_ratio_highest": 4.664,
        "predict_vola_val_newest": 18.4635,
        "predict_vola_val_highest": 25.7935,
        "option_iv_crush": 2.569,
        "option_strike_date_iv_crush": 24.661,
        "trading_day": 1773849600000,
        "trading_day_str": "2026-03-19",
        "open_price": 522.7,
        "close_price": 507.7,
        "highest_price": 524.2,
        "lowest_price": 506.7,
        "last_close_price": 545.2,
        "volume": 59432769,
        "schedule_delta": -15,
        "schedule_close_price": 500.7
      }
    ]
  }
}