組合期權價差
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
}
}