期權到期日
GET/v1/quote/{symbol}/option-expiration獲取指定正股的期權到期日列表。
請求參數
| 參數 | 類型 | 位置 | 必填 | 說明 |
|---|---|---|---|---|
symbol | string | 路徑 | 是 | 期權標的代碼，例 HK.00700、US.AAPL、HK.800000（恒指）。 |
index_option_type | int | 查詢 | 否 | 指數期權類型，僅指數標的需傳，普通正股不傳。詳見命名詞典。 |
filter_standard | string | 查詢 | 否 | 按標準/非標準過濾，默認 ALL。詳見命名詞典。 |
filter_expiration_cycles | string | 查詢 | 否 | 按到期週期過濾，逗號分隔（如 MONTH,QUARTERLY），不傳或空串=不過濾。詳見命名詞典。 |
請求示例
bash
curl '$ip/v1/quote/HK.00700/option-expiration' | jq響應字段
返回 data.expiration_list[]，每元素一份到期日記錄：
| 字段 | 類型 | 說明 |
|---|---|---|
strike_time | string | 行權日，格式 yyyy-MM-dd。 |
option_expiry_date_distance | int | 距到期日天數（負數=已過期）。 |
expiration_cycle | string | 到期週期。詳見命名詞典。 |
限制範圍
- 支持市場：HK / US / JP；其他市場返回
ret_code=-8 unsupported。 - 支持品類：港美日正股；港股恒指 / 國指 / 恒科及小型指數；美股 VIX / XSP / DJX / OEX / RUT 等指數；日股 N225 / N225M / TOPIX。
- 指數標的必須傳
index_option_type，否則返回空；普通正股不傳該參數。
錯誤碼
| ret_code | error.code | 觸發條件 | 處理建議 |
|---|---|---|---|
| 0 | — | 成功 | — |
| -3 | invalid_parameter | symbol 缺失 / 不合法；index_option_type / filter_standard / filter_expiration_cycles 取值不在枚舉集合 | 校正請求參數後重試 |
| -7 | invalid_symbol | 路徑 symbol 在證券庫查不到 | 通過搜索接口確認代碼合法性 |
| -8 | unsupported | symbol 市場不在 HK / US / JP | 該市場不支持期權鏈，無需重試 |
| -10 | no_data | 合法標的但當前無任何期權到期日（含過濾後為空） | 視為該標的當前無期權數據 |
| -5 | internal_error | 網關內部錯誤 / 後端調用失敗 / 超時 | 稍後重試或聯繫平台 |
響應示例
json
{
"ret_code": 0,
"ret_msg": "",
"data": {
"expiration_list": [
{ "strike_time": "2026-06-29", "option_expiry_date_distance": 25, "expiration_cycle": "MONTH" },
{ "strike_time": "2026-07-30", "option_expiry_date_distance": 56, "expiration_cycle": "MONTH" },
{ "strike_time": "2026-12-30", "option_expiry_date_distance": 209, "expiration_cycle": "QUARTERLY" }
]
}
}