Earnings Price History

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

Get the stock price performance on historical earnings release dates and surrounding offset days. Each earnings period returns: option predicted volatility, post-earnings IV crush, OHLC for the earnings trading day, and a daily close price series from -15 to +14 days centered on the disclosure date.

Parameters

Name	Type	In	Required	Description
symbol	string	path	yes	Symbol code, e.g. HK.00700.

Request Example

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

Response Fields

Returns data.records[]. Each earnings period contains 30 rows (schedule_delta from -15 to +14).

Earnings period identification and disclosure info:

Field	Type	Description
fiscal_year	int	Fiscal year, e.g. 2025.
financial_type	int	Earnings period type code, see naming dictionary.
period_text	string	Earnings period text, e.g. 2025/Q4.
is_current	bool	Whether this is the latest period.
pub_trading_day	int	Disclosure trading day, millisecond timestamp.
pub_trading_day_str	string	Disclosure trading day string (yyyy-MM-dd).
pub_time	int	Disclosure time, seconds timestamp.
pub_time_str	string	Disclosure time string (yyyy-MM-dd HH:mm:ss).
pub_type	int	Disclosure timing type, see naming dictionary.

Option predicted volatility and IV crush:

Field	Type	Description
predict_vola_ratio_newest	float	Latest predicted volatility ratio (%).
predict_vola_ratio_highest	float	Highest predicted volatility ratio (%).
predict_vola_val_newest	float	Latest predicted volatility value (pricing currency).
predict_vola_val_highest	float	Highest predicted volatility value (pricing currency).
option_iv_crush	float	Post-earnings IV crush (percentage points).
option_strike_date_iv_crush	float	Earnings expiration date IV crush (percentage points).

Earnings trading day quotes:

Field	Type	Description
trading_day	int	Earnings trading day, millisecond timestamp.
trading_day_str	string	Earnings trading day string (yyyy-MM-dd).
open_price	float	Open price.
close_price	float	Close price.
highest_price	float	High price.
lowest_price	float	Low price.
last_close_price	float	Previous close price.
volume	int	Trading volume (shares).

Disclosure date offset series:

Field	Type	Description
schedule_delta	int	Offset days relative to disclosure date (-15 to +14; 0=disclosure day).
schedule_close_price	float	Close price on that offset day.

Supported Markets

• Markets: HK / US / SH / SZ only; other markets return unsupported.
• Categories: Equities only; ETF / indices / warrants / options have no earnings data, return no_data.
• For supported market equities, if the backend has no earnings-day price data, also returns no_data.

Error Codes

ret_code	error.code	Trigger Condition	Suggested Action
0	—	Normal response	—
-3	invalid_parameter	Invalid symbol format	Fix code format and retry
-7	invalid_symbol	Symbol format valid but no matching security	Use the search API to verify the symbol
-8	unsupported	Market not in HK / US / SH / SZ	Only call for equities in supported markets
-10	no_data	Valid request but no earnings-day price data	No data available for this symbol, no retry needed
-6	internal_error	Gateway internal error	Retry; contact support if persistent

Response Example

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