Earnings Price Move

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

Get the stock price movement around earnings disclosure dates. Returns daily quote sequences centered on the disclosure date across multiple reporting periods (open/close/high/low/previous close/volume, option IV/HV), along with an overview summary for the entire request (average earnings-day price change over recent N periods).

Parameters

Name	Type	In	Required	Description
symbol	string	path	yes	Symbol code, e.g. HK.00700.
count	int	query	no	Number of recent earnings periods to return. Default 10, max 50.
overview_count	int	query	no	Number of earnings periods for overview statistics. Default 8, max 50. Effective value = min(overview_count, count).

Request Example

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

Response Fields

Returns data.records[] (daily quotes) and data top-level overview summary fields.

records fields:

Field	Type	Description
fiscal_year	int	Fiscal year, e.g. 2025.
financial_type	int	Earnings period type, see Naming Dictionary.
period_text	string	Earnings period text, e.g. 2025/Q4.
pub_trading_day	int	Disclosure day trading timestamp (seconds).
pub_trading_day_str	string	Disclosure day string (yyyy-MM-dd, market timezone).
pub_type	int	Earnings disclosure timing type, see Naming Dictionary.
price_info_index	int	Index of disclosure day in the sub-array (i.e. where day_offset=0).
day_offset	int	Offset days relative to disclosure day (0=disclosure day, negative=before, positive=after).
trading_day	int	Current row trading day timestamp (seconds).
trading_day_str	string	Current row trading day string (yyyy-MM-dd, market timezone).
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.
option_iv	float	Option implied volatility (%); may be 0 for symbols without options.
option_hv	float	Option historical volatility (%); may be 0 for symbols without options.
volume	int	Current row trading day volume (shares).
volume_precision	int	Volume precision n, actual volume = volume / 10^n (usually 0).

data top-level overview summary fields:

Field	Type	Description
overview_recent_period_count	int	Actual number of earnings periods N used in overview statistics.
overview_avg_earnings_day_change_pct	float	Average earnings-day price change (%) over recent N periods, e.g. 1.15 means +1.15%.

Supported Markets

• Supported markets: HK / US / SH / SZ / CA / AU equities / ADR; other market equities may have no data (returns empty records).
• Only applicable to equities; options / futures / forex / indices etc. are not supported (returns unsupported).
• Valid symbols with no earnings price data return ret_code=0 + empty records.

Error Codes

ret_code	error.code	Trigger Condition	Suggested Action
0	—	Success (including valid but no data, records=[])	—
-3	invalid_parameter	Parameter type/range invalid (e.g. count > 50)	Fix parameters and retry
-7	invalid_symbol	Symbol cannot resolve to a security	Use the search API to verify the symbol
-8	unsupported	Non-equity category (options/futures/forex etc.)	This API only supports equities, use equity symbol
-4 / -6	internal_error	Gateway internal error	Retry later; contact support if persistent

Response Example

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