组合期权价差
GET/api/v1.0/quote/{symbol}/option-strategy-spread查询指定标的、策略、到期日下服务端给出的价差列表及默认价差。 返回 spread_list（实际价格）和 default_spread（实际价格）。 支持美股和港股股票/ETF 期权；港指、日股及其他市场返回 -8。港股 Covered(2) / Collar(8) 返回 -8。 CalendarSpread(15) / DiagonalSpread(16) 必须传 far_expire_time。 无匹配价差（含该到期日在当前 filter_standard 下没有合约）返回 ret_code=0 且 spread_list=[]。 拿到价差后再用 quote.option_strategy 查组合列表。
请求参数
| 参数 | 类型 | 位置 | 必填 | 说明 |
|---|---|---|---|---|
symbol | string | 路径 | 是 | 期权标的代码（路径参数），美股或港股正股/ETF。例: US.AAPL / HK.00700 |
strategy | int | 查询 | 是 | 组合策略类型，取值同 quote.option_strategy。港股不支持 2/8 |
expire_time | string | 查询 | 是 | 近月到期日 yyyy-MM-dd，例: 2026-08-21 |
far_expire_time | string | 查询 | 否 | 远月到期日 yyyy-MM-dd；CalendarSpread / DiagonalSpread 必填 |
index_option_type | int | 查询 | 否 | 美股指数期权类型，仅美股指数标的需传，普通正股不传。港指没有组合期权，勿传 1-5 |
filter_standard | string | 查询 | 否 | 按标准/非标准期权过滤；与到期日查询一致 |
请求示例
bash
curl 'https://webapi.moomoo.com/api/v1.0/quote/US.AAPL/option-strategy-spread?strategy=1&expire_time=value' | jq响应字段
| 参数 | 类型 | 说明 |
|---|---|---|
data.spread_list | number | 价差列表 |
data.default_spread | number | 默认价差；spread_list 为空时无效 |
错误码
| 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": {
"spread_list": 1.2,
"default_spread": 1.2
}
}