Earnings Cycle Option Analysis

GET /api/v1.0/quote/{code}/option-earnings-report-cycle

Get option earnings-cycle analysis for an underlying, combining expected move, daily IV/HV & price series around earnings, and historical IV Crush details. Supported markets: US / HK.

Request

Parameter	Type	In	Required	Description
code	string	path	yes	Option underlying symbol (path param), e.g. US.TSLA / US.AAPL / HK.00700

Example

curl -X GET 'https://webapi.moomoo.com/api/v1.0/quote/US.AAPL/option-earnings-report-cycle' \
  -H 'Authorization: Bearer <AccessToken>' | jq

Response

Field	Type	Description
data.expected_moves	object	Expected move list across earnings quarters (newest first)
data.expected_moves[].earnings_quarter	string	Earnings quarter, e.g. '2026Q1'
data.expected_moves[].pub_time	integer	Earnings release timestamp in seconds
data.expected_moves[].pub_type	integer	Release session: PRE_MARKET / AFTER_HOURS / REGULAR
data.expected_moves[].expected_move_ratio_newest	number	Latest expected move percentage (percent)
data.expected_moves[].expected_move_ratio_highest	number	Highest expected move percentage (percent)
data.expected_moves[].close_price	number	Close price on the earnings trading day
data.expected_moves[].last_close_price	number	Previous trading day close price
data.history_details	object	Historical earnings cycle IV Crush and price details
data.history_details[].earnings_quarter	string	Earnings quarter
data.history_details[].pub_time	integer	Release timestamp in seconds
data.history_details[].is_current_report_cycle	string	Whether this is the current earnings cycle
data.history_details[].iv_crush	number	Overall IV Crush (percent)
data.history_details[].strike_date_iv_crush	number	Nearest expiry IV Crush (percent)
data.history_details[].expected_move_ratio_newest	number	Expected move percentage (percent)
data.history_details[].open_price	number	Open price on earnings day
data.history_details[].high_price	number	High price on earnings day
data.history_details[].low_price	number	Low price on earnings day
data.cycle_quotes	object	Daily IV/HV and price series around each earnings cycle
data.cycle_quotes[].earnings_quarter	string	Earnings quarter
data.cycle_quotes[].pub_trading_day_index	integer	Index of the earnings trading day in items
data.cycle_quotes[].items	object
data.cycle_quotes[].items[].trading_day	integer	Trading day YYYY-MM-DD
data.cycle_quotes[].items[].iv	number	Implied volatility (percent)
data.cycle_quotes[].items[].hv	number	Historical volatility (percent)
data.cycle_quotes[].items[].close_price	number	Close price

Errors

ret_code	error.code	Description
0	—	Success
-3	invalid_parameter	Missing or invalid parameter
-7	invalid_symbol	Unknown symbol
-8	unsupported	Market or product is not supported
-9	permission_denied	Missing permission
-10	no_data	No data
-11	rate_limited	Too many requests

Sample

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "expected_moves": "example",
    "history_details": "example",
    "cycle_quotes": "example"
  }
}