财报价格历史

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
      }
    ]
  }
}