期权到期日

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），不传或空串=不过滤。详见命名词典。

请求示例

curl '$ip/v1/quote/HK.00700/option-expiration?filter_standard=STANDARD&filter_expiration_cycles=MONTH,QUARTERLY' | 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	网关内部错误 / 后端调用失败 / 超时	稍后重试或联系平台

响应示例

{
  "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" }
    ]
  }
}