期权到期日
GET/api/v1.0/quote/{symbol}/option-expiration获取指定标的的期权到期日列表。 返回包含：行权日（yyyy-MM-dd）、距到期日天数（负数=已过期）、到期周期（MONTH/WEEK/END_OF_MONTH/QUARTERLY/WEEKMON-FRI/N/A）。 支持市场：HK / US / JP；其他市场返回 ret_code=-8 unsupported。 支持港美日正股，及港股恒指/国指/恒科等指数与美股 VIX/XSP/DJX/OEX 及板块/RUT 等指数标的；指数标的需传 index_option_type，普通正股不传。 暂不支持的指数：US..SPX、US..NDX（暂无数据，已从 index_option_type 枚举移除）。 期权链合约明细请用 quote.option_chain；期权 IV/HV 分析请用 quote.option_volatility；行权概率请用 quote.option_exercise_probability。
请求参数
| 参数 | 类型 | 位置 | 必填 | 说明 |
|---|---|---|---|---|
symbol | string | 路径 | 是 | 期权标的代码（路径参数）。支持港美正股 / 港股恒指国指恒科指数 / 美股 SPX/VIX/NDX 等，例: HK.00700 |
index_option_type | int | 查询 | 否 | 指数期权类型（仅指数标的需要，普通正股不传）。港股: 1=HSI/2=HSCEI/3=Mini-HSI/4=Mini-HSCEI/5=HSTECH；美股: 1000=兜底指数期权/1001=VIX/1003=XSP/1005=EFS/1006=MXS/1007=DJX/1008=OEX/1009=SIXB/1010=SIXI/1011=SIXM/1012=SIXU/1013=SIXV/1014=XEO/1015=BKX/1016=XAU/1017=OSX/1018=SOX/1019=UTY/1020=RUT/1021=SIXRE/1022=XND/1023=CBTX/1024=MBTX；日股: 2001=N225/2002=N225M/2003=TOPIX。SPX(1002)/NDX(1004) 暂无数据，已移除 |
filter_standard | string | 查询 | 否 | 按标准/非标准期权过滤；ALL=全部（默认），STANDARD=仅标准期权，NON_STANDARD=仅非标准期权（FLEX 等调整后合约） |
filter_expiration_cycles | string | 查询 | 否 | 按到期周期过滤，逗号分隔；取值见出参 expiration_cycle 枚举（如 MONTH,QUARTERLY）；不传或空串=不过滤 |
请求示例
bash
curl 'https://webapi.moomoo.com/api/v1.0/quote/US.AAPL/option-expiration' | jq响应字段
| 参数 | 类型 | 说明 |
|---|---|---|
data.expiration_list | object[] | |
data.expiration_list[].strike_time | string | 行权日，格式 yyyy-MM-dd，例: 2026-05-28 |
data.expiration_list[].option_expiry_date_distance | int | 距到期日天数（负数=已过期），例: 5 |
data.expiration_list[].expiration_cycle | int | 到期周期，取值: MONTH / WEEK / END_OF_MONTH / QUARTERLY / WEEKMON / WEEKTUE / WEEKWED / WEEKTHU / WEEKFRI / N/A |
错误码
| 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": {
"expiration_list": [
{
"strike_time": "example",
"option_expiry_date_distance": 0,
"expiration_cycle": 0
}
]
}
}