财报价格走势

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

财报价格走势 ​

请求参数 ​

请求示例 ​

响应字段 ​

限制范围 ​

错误码 ​

响应示例 ​