組合期權詢價

POST /api/v1.0/quote/combo-option-quote

按調用方給出的組合腿（合約 + BUY/SELL + 數量）詢價。

返回每組的組合市價 / 買賣一價量 / 成交量額 / 昨收，並回顯請求腿。

本接口為實時行情，需登錄且該市場品類有實時權限。

請求參數

參數	類型	位置	必填	說明
`combo_list`	object[]	請求體	是	組合列表，`1~20` 組。每元素見下表。

combo_list[] 每個元素：

字段	類型	必填	說明
`legs`	object[]	是	該組的腿列表，至少 1 條。

legs[] 每個元素：

字段	類型	必填	說明
`code`	string	是	美股 / 港股期權合約，或備兌時的標的正股。期權例 `US.AAPL260821C110000`；備兌再加 `US.AAPL` `BUY` `100`。一組最多一條正股。
`side`	string	是	買賣方向。詳見命名詞典。
`quantity`	int	是	數量，正整數。

請求示例

bash

curl -s -X POST 'https://webapi.moomoo.com/api/v1.0/quote/combo-option-quote' \
  -H 'Content-Type: application/json' \
  -H 'X-Futu-Client-Nnid: 76879657' \
  -d '{"combo_list":[{"legs":[{"code":"US.AAPL260821C110000","side":"BUY","quantity":1},{"code":"US.AAPL260821P110000","side":"BUY","quantity":1}]}]}' | jq

響應字段

返回 data.quote_list[]，每元素一組詢價結果：

字段	類型	說明
`rsp_code`	int	單組詢價結果碼，`0`=成功。整包失敗走頂層 `ret_code`；單組失敗留在本字段。
`legs`	object[]	回顯的請求腿（`code` / `side` / `quantity`）。
`price`	number	組合市價（已還原）。後端未下發則省略。
`bid_price`	number	買一價（已還原）。後端未下發則省略。
`ask_price`	number	賣一價（已還原）。後端未下發則省略。
`bid_volume`	number	買一量。後端未下發則省略。
`ask_volume`	number	賣一量。後端未下發則省略。
`volume`	number	組合成交量。後端未下發則省略。
`turnover`	number	組合成交額（已還原）。後端未下發則省略。
`last_close_price`	number	昨收價（已還原）。後端未下發則省略。

限制範圍

僅支持美股、港股；日股等返回 ret_code=-8 unsupported。
combo_list 最多 20 組。腿可以是期權合約，備兌可帶一條標的正股（映射到 QTA underlying_info）。一組兩條正股會 -3。
實時行情：未登錄或無該市場品類實時權限返回 ret_code=-9。
後端未下發的報價字段省略，不編造 0。

錯誤碼

ret_code	error.code	觸發條件	處理建議
0	—	整包成功（單組失敗看 `item.rsp_code`）	逐組檢查 `rsp_code`
-3	invalid_parameter	`combo_list` 缺失 / 為空 / 超過 20 組；`legs` 為空；`side` 不是 `BUY`/`SELL`；`quantity` 不是正整數；`code` 格式非法；一組超過一條正股	校正請求體後重試
-7	invalid_symbol	`code` 在證券庫查不到	通過搜索或期權鏈確認合約代碼
-8	unsupported	`code` 市場不是 US / HK	該市場不支持組合詢價，無需重試
-9	permission_denied	未登錄 / 無該市場品類實時行情權限	補齊用戶身份並確認實時權限
-5	internal_error	網關內部錯誤 / 後端調用失敗 / 超時	稍後重試或聯繫平臺

響應示例

json

{
  "ret_code": 0,
  "ret_msg": "",
  "data": {
    "quote_list": [
      {
        "rsp_code": 0,
        "legs": [
          { "code": "US.AAPL260821C110000", "side": "BUY", "quantity": 1 },
          { "code": "US.AAPL260821P110000", "side": "BUY", "quantity": 1 }
        ],
        "price": 4.35,
        "bid_price": 4.3,
        "ask_price": 4.4,
        "bid_volume": 12,
        "ask_volume": 9,
        "volume": 320,
        "turnover": 139200,
        "last_close_price": 4.1
      }
    ]
  }
}

組合期權詢價 ​

請求參數 ​

請求示例 ​

響應字段 ​

限制範圍 ​

錯誤碼 ​