组合期权询价

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
      }
    ]
  }
}

组合期权询价 ​

请求参数 ​

请求示例 ​

响应字段 ​

限制范围 ​

错误码 ​