組合期權策略
GET/api/v1.0/quote/{symbol}/option-strategy按標的、策略類型和到期日查詢組合期權列表。 返回 combo_list[]：一項永遠是一套組合，腿統一在 legs[]（instrument=OPTION 或 STOCK）。 認購與認沽組合分別返回，每條記錄對應一套組合。 Covered(2) / Collar(8) 在期權腿前補路徑正股（instrument=STOCK，code=路徑 symbol）；不下發 side / quantity，詢價時由調用方在 quote.combo_option_quote 自行指定 BUY/SELL。 支持美股（含美股指數期權）和港股股票/ETF 期權；港指、日股及其他市場返回 ret_code=-8 unsupported。 港股不支持 Covered(2) / Collar(8)，請求同樣返回 -8。 CalendarSpread(15) / DiagonalSpread(16) 必須同時傳 far_expire_time。 無匹配組合（含該到期日在當前 filter_standard 下沒有合約）返回 ret_code=0 且 combo_list=[]。 價差列表請用 quote.option_strategy_spread；組合詢價請用 quote.combo_option_quote。
請求參數
| 參數 | 類型 | 位置 | 必填 | 說明 |
|---|---|---|---|---|
symbol | string | 路徑 | 是 | 期權標的代碼（路徑參數），美股或港股正股/ETF。例: US.AAPL / HK.00700 |
strategy | int | 查詢 | 是 | 組合策略類型。1=SingleOption 2=Covered 4=Spread 6=Straddle 7=Strangle 8=Collar 9=Butterfly 11=Condor 13=IronButterfly 14=IronCondor 15=CalendarSpread 16=DiagonalSpread 100=Customize。港股不支持 2/8 |
expire_time | string | 查詢 | 是 | 近月到期日 yyyy-MM-dd，例: 2026-08-21 |
far_expire_time | string | 查詢 | 否 | 遠月到期日 yyyy-MM-dd；CalendarSpread / DiagonalSpread 必填 |
spread | number | 查詢 | 否 | 價差（真實價格，範圍 0~9223372036）。4/7/8/9/11/13/14/16 必填，不傳返回 -5。先調 quote.option_strategy_spread 取 default_spread 或 spread_list 中的值。1/2/6/15/100 可不傳 |
index_option_type | int | 查詢 | 否 | 美股指數期權類型，僅美股指數標的需傳，普通正股不傳。港指沒有組合期權，1-5（HSI/HSCEI/HSTECH 等）不可用於本接口。取值同 quote.option_chain 的美股段（1000+） |
filter_standard | string | 查詢 | 否 | 按標準/非標準期權過濾；ALL=全部（默認），STANDARD=僅標準，NON_STANDARD=僅非標準 |
請求示例
bash
curl 'https://webapi.moomoo.com/api/v1.0/quote/US.AAPL/option-strategy?strategy=1&expire_time=value' | jq響應字段
| 參數 | 類型 | 說明 |
|---|---|---|
data.combo_list | object[] | |
data.combo_list[].strategy | int | 組合策略類型，取值同入參 strategy |
data.combo_list[].legs | object[] | |
data.combo_list[].legs[].code | string | 腿代碼。期權例: US.AAPL260918C50000；Covered/Collar 正股例: US.AAPL |
data.combo_list[].legs[].instrument | string | 腿品類：OPTION=期權合約，STOCK=標的正股（僅 Covered/Collar 包含正股腿） |
data.combo_list[].legs[].strike_price | number | 行權價；正股腿不下發 |
data.combo_list[].legs[].option_standard_type | int | 期權規格類型：STANDARD / NON_STANDARD / 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": {
"combo_list": [
{
"strategy": 0,
"legs": "example"
}
]
}
}