组合期权策略
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"
}
]
}
}