組合期權策略

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