期權到期日
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
}
]
}
}