財報週期期權分析

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

獲取指定標的在本次及歷次財報週期的期權預測波動（Expected Move）、財報週期前後單日 IV/HV 與股價表現以及歷次財報 IV Crush 明細。 一次請求返回預期波動、財報週期表現與歷史 IV Crush 數據。 支持市場：US / HK。

請求參數

參數	類型	位置	必填	說明
code	string	路徑	是	期權標的代碼（路徑參數），例: US.TSLA / US.AAPL / HK.00700

請求示例

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

響應參數

參數	類型	說明
data.expected_moves	object	各財報週期的期權預測波動列表（按財報日從近到遠）
data.expected_moves[].earnings_quarter	string	財報週期，例: '2026Q1'
data.expected_moves[].pub_time	integer	財報發佈時間戳（秒）
data.expected_moves[].pub_type	integer	發佈時段：PRE_MARKET=盤前 / AFTER_HOURS=盤後 / REGULAR=當天
data.expected_moves[].expected_move_ratio_newest	number	預測波動百分比最新值（百分數，2.489 表示 2.489%）
data.expected_moves[].expected_move_ratio_highest	number	預測波動百分比最高值（百分數）
data.expected_moves[].close_price	number	財報對應交易日收盤價
data.expected_moves[].last_close_price	number	前一交易日收盤價
data.history_details	object	歷次財報週期 IV Crush 與股價波動明細列表
data.history_details[].earnings_quarter	string	財報週期
data.history_details[].pub_time	integer	發佈時間戳（秒）
data.history_details[].is_current_report_cycle	string	是否為當前最新財報週期
data.history_details[].iv_crush	number	標的整體 IV Crush（百分數）
data.history_details[].strike_date_iv_crush	number	最近到期日鏈 IV Crush（百分數）
data.history_details[].expected_move_ratio_newest	number	預測波動百分比（百分數）
data.history_details[].open_price	number	財報日開盤價
data.history_details[].high_price	number	財報日最高價
data.history_details[].low_price	number	財報日最低價
data.cycle_quotes	object	各財報週期前後單日 IV/HV 與股價時間序列
data.cycle_quotes[].earnings_quarter	string	財報週期
data.cycle_quotes[].pub_trading_day_index	integer	財報發佈交易日在 items 中的索引下標
data.cycle_quotes[].items	object
data.cycle_quotes[].items[].trading_day	integer	交易日 YYYY-MM-DD
data.cycle_quotes[].items[].iv	number	隱含波動率（百分數）
data.cycle_quotes[].items[].hv	number	歷史波動率（百分數）
data.cycle_quotes[].items[].close_price	number	收盤價

錯誤碼

ret_code	error.code	說明
0	—	成功
-3	invalid_parameter	參數缺失或不在允許範圍內
-7	invalid_symbol	標的不存在
-8	unsupported	市場或品類不支持
-9	permission_denied	沒有對應權限
-10	no_data	沒有可返回的數據
-11	rate_limited	調用過於頻繁

響應示例

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