财报周期期权分析
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 |
请求示例
bash
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 | 调用过于频繁 |
响应示例
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"expected_moves": "example",
"history_details": "example",
"cycle_quotes": "example"
}
}