Skip to content

Combo Option Quote ​

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

Get combo option quotes using caller-supplied legs (contract + BUY/SELL + quantity). side is required from the caller; it is not inferred from strategy type. Returns per-combo price / bid_price / ask_price / bid_volume / ask_volume / volume / turnover / last_close_price (prices and turnover are returned as actual amounts), plus echoed legs. Greeks, IV, break-even points, and OHLC data are not returned. Supports US and HK option contracts. US Covered combinations may include one underlying stock leg (e.g. US.AAPL BUY 100). HK does not support stock legs (Covered) and returns -8. Errors for individual combinations are returned in item.rsp_code. Realtime quote; login and realtime permission required.

Parameters ​

NameTypeInRequiredDescription
combo_liststringbodyyesCombo list. Each element is one combo; legs in legs[]. US/HK option contracts; US Covered may add one underlying stock. HK stock legs are not supported. At most one stock leg per combo; all legs in a combo must share the same market.

Example ​

bash
curl -X POST 'https://webapi.moomoo.com/api/v1.0/quote/combo-option-quote' -H 'Content-Type: application/json' -d '{}' | jq

Response ​

NameTypeDescription
data.quote_listobject[]
data.quote_list[].rsp_codestringPer-combo quote result code, 0=success
data.quote_list[].legsstringEchoed request legs (code / side / quantity)
data.quote_list[].pricestringCombo nominal price (already /1e9)
data.quote_list[].bid_pricestringBid price (already /1e9)
data.quote_list[].ask_pricestringAsk price (already /1e9)
data.quote_list[].bid_volumestringBid volume
data.quote_list[].ask_volumestringAsk volume
data.quote_list[].volumestringCombo volume
data.quote_list[].turnoverstringCombo turnover (already /1e3)
data.quote_list[].last_close_pricestringPrevious close (already /1e9)

Errors ​

ret_codeerror.codeWhen
0—Success
-3invalid_parameterA parameter is missing or not in the allowed set
-7invalid_symbolSymbol is not in the security master
-8unsupportedMarket or instrument is outside this API
-9permission_deniedAuthenticated, but without quote permission
-10no_dataNothing is returned
-11rate_limitedPer-user rate limit

Response example ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "quote_list": [
      {
        "rsp_code": "example",
        "legs": "example",
        "price": "example",
        "bid_price": "example",
        "ask_price": "example",
        "bid_volume": "example",
        "ask_volume": "example",
        "volume": "example",
        "turnover": "example",
        "last_close_price": "example"
      }
    ]
  }
}