Combo Option Quote

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

Quote combo option packages using caller-supplied legs (contract + BUY/SELL + quantity).

Returns per-combo nominal price / bid-ask / volume / turnover / previous close, plus echoed request legs.

Leg symbols can be obtained from Combo Option Strategy or Option Chain.

This is a real-time quote API; login and real-time permission for the market's product category are required.

Parameters

Name	Type	In	Required	Description
combo_list	object[]	body	yes	Combo list, 1~20 items. Each element is described below.

Each element of combo_list[]:

Field	Type	Required	Description
legs	object[]	yes	Legs of this combo, at least 1.

Each element of legs[]:

Field	Type	Required	Description
code	string	yes	US or HK option contract, or the underlying stock for Covered. Option e.g. US.AAPL260821C110000; Covered adds US.AAPL BUY 100. At most one stock leg per combo.
side	string	yes	Trade side. See Naming Dictionary.
quantity	int	yes	Quantity, a positive integer.

Request Example

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

Response Fields

Returns data.quote_list[], each element is one combo quote:

Field	Type	Description
rsp_code	int	Per-combo result code, 0=success. Package-level failures use top-level ret_code; per-item failures stay in this field.
legs	object[]	Echoed request legs (code / side / quantity).
price	number	Combo nominal price (already restored). Omitted if the backend did not send it.
bid_price	number	Bid price (already restored). Omitted if the backend did not send it.
ask_price	number	Ask price (already restored). Omitted if the backend did not send it.
bid_volume	number	Bid volume. Omitted if the backend did not send it.
ask_volume	number	Ask volume. Omitted if the backend did not send it.
volume	number	Combo volume. Omitted if the backend did not send it.
turnover	number	Combo turnover (already restored). Omitted if the backend did not send it.
last_close_price	number	Previous close (already restored). Omitted if the backend did not send it.

Supported Markets

• US and HK only; JP and others return ret_code=-8 unsupported.
• combo_list allows at most 20 combos. Legs may be option contracts; Covered may include one underlying stock (mapped to QTA underlying_info). Two stock legs in one combo return -3.
• Real-time quote: not logged in or missing real-time permission for the market's product category returns ret_code=-9.
• Quote fields not sent by the backend are omitted; the API does not invent 0.

Error Codes

ret_code	error.code	Trigger Scenario	Suggested Handling
0	—	Package succeeded (check item.rsp_code for per-combo failures)	Inspect rsp_code per item
-3	invalid_parameter	combo_list missing / empty / more than 20 items; empty legs; side is not BUY/SELL; quantity is not a positive integer; code has an invalid format; more than one stock leg in a combo	Correct the request body and retry
-7	invalid_symbol	code not found in security database	Verify the contract via search or option chain
-8	unsupported	code market is not US or HK	This market does not support combo quoting, no need to retry
-9	permission_denied	Not logged in / no real-time quote permission for the market's product category	Provide user identity and confirm real-time permission
-5	internal_error	Gateway internal error / backend call failure / timeout	Retry later or contact platform

Response Example

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