组合期权策略

GET /api/v1.0/quote/{symbol}/option-strategy

按标的、策略类型和到期日查询组合期权列表。返回 combo_list[]：一项永远是一套组合，腿统一在 legs[]（期权 instrument=OPTION，Covered/Collar 另含路径正股 instrument=STOCK）。

价差类策略可先调组合期权价差拿到 spread_list / default_spread，再把 spread 传入本接口。

请求参数

参数	类型	位置	必填	说明
symbol	string	路径	是	期权标的代码，美股或港股正股/ETF。例 US.AAPL / HK.00700。
strategy	int	查询	是	组合策略类型。详见命名词典。港股不支持 Covered(2) / Collar(8)。
expire_time	string	查询	是	近月到期日 yyyy-MM-dd，例 2026-08-21。
far_expire_time	string	查询	条件必填	远月到期日 yyyy-MM-dd。CalendarSpread(15) / DiagonalSpread(16) 必填，且必须晚于 expire_time。
spread	number	查询	条件必填	价差（真实价格，范围 0~9223372036）。4/7/8/9/11/13/14/16 必填，不传后端返回 -5。先调组合期权价差取 default_spread 或 spread_list 中的值。1/2/6/15/100 可不传。详见命名词典。
index_option_type	int	查询	否	美股指数期权类型，仅美股指数标的需传，普通正股不传。取值用命名词典 US 段（1000+）。详见命名词典。
filter_standard	string	查询	否	按标准/非标准过滤，默认 ALL。详见命名词典。

请求示例

curl 'https://webapi.moomoo.com/api/v1.0/quote/US.AAPL/option-strategy?strategy=2&expire_time=2026-09-18' | jq
curl 'https://webapi.moomoo.com/api/v1.0/quote/US.AAPL/option-strategy?strategy=6&expire_time=2026-08-21' | jq
curl 'https://webapi.moomoo.com/api/v1.0/quote/US.AAPL/option-strategy?strategy=4&expire_time=2026-08-21&spread=5' | jq
curl 'https://webapi.moomoo.com/api/v1.0/quote/HK.00700/option-strategy?strategy=6&expire_time=2026-09-29' | jq

响应字段

返回 data.combo_list[]，每元素一套组合：

字段	类型	说明
strategy	int	组合策略类型，取值同入参。详见命名词典。
legs	object[]	该组合的全部腿，见下表。Covered/Collar 第一腿为正股，其后为期权。

legs[] 每个元素：

字段	类型	说明
code	string	腿代码。期权例 US.AAPL260918C50000；正股例 US.AAPL。
instrument	string	腿品类。OPTION=期权合约，STOCK=标的正股（仅 Covered/Collar）。详见命名词典。
strike_price	number	行权价（已还原为真实数值）。仅期权腿下发。
option_standard_type	string	期权规格类型。仅期权腿下发。详见命名词典。

本接口不下发 side / quantity。询价时由调用方在组合期权询价自行指定买卖方向和数量。

限制范围

• 支持美股（含美股指数期权）和港股股票/ETF 期权；港指、日股及其他市场返回 ret_code=-8 unsupported。
• 港股不支持 Covered(2) / Collar(8)，请求同样返回 -8。
• 指数标的必须传 index_option_type（US 段）；普通正股不传该参数。
• expire_time 必须是该标的真实到期日（可用期权到期日查询）。
• 价差类策略（4/7/8/9/11/13/14/16）必须带 spread；日历/对角还须 far_expire_time。完整表见命名词典。
• 当前无匹配组合时返回空 combo_list，ret_code=0。

错误码

ret_code	error.code	触发条件	处理建议
0	—	成功（含空列表）	—
-3	invalid_parameter	symbol / strategy / expire_time 缺失或不合法；日期格式不是 yyyy-MM-dd；CalendarSpread / DiagonalSpread 未传 far_expire_time，或远月不晚于近月	校正请求参数后重试
-7	invalid_symbol	路径 symbol 在证券库查不到	通过搜索接口确认代码合法性
-8	unsupported	市场不是美股/港股股票或 ETF；或港股请求了 Covered(2) / Collar(8)	该标的或策略不支持组合期权，无需重试
-5	internal_error	网关内部错误 / 后端调用失败 / 超时；价差类策略未传 spread 时也是此码	先调价差接口带上 spread 后重试；仍失败则联系平台

响应示例

Covered：一项一套担保组合，BFF 补正股腿。

{
  "ret_code": 0,
  "ret_msg": "",
  "data": {
    "combo_list": [
      {
        "strategy": 2,
        "legs": [
          { "code": "US.AAPL", "instrument": "STOCK" },
          { "code": "US.AAPL260918C50000", "instrument": "OPTION", "strike_price": 50, "option_standard_type": "STANDARD" }
        ]
      }
    ]
  }
}

跨式：一项一套，两腿都是期权，不补正股。

{
  "ret_code": 0,
  "ret_msg": "",
  "data": {
    "combo_list": [
      {
        "strategy": 6,
        "legs": [
          { "code": "US.AAPL260918P50000", "instrument": "OPTION", "strike_price": 50, "option_standard_type": "STANDARD" },
          { "code": "US.AAPL260918C50000", "instrument": "OPTION", "strike_price": 50, "option_standard_type": "STANDARD" }
        ]
      }
    ]
  }
}