Skip to content

Combo Option Spread ​

GET /api/v1.0/quote/{symbol}/option-strategy-spread

Query the server spread list and default spread for an underlying + strategy + expiry. Returns spread_list (actual price) and default_spread (actual price). Supports US and HK equity/ETF options; HK index, JP and other markets return -8. HK Covered(2) / Collar(8) return -8. CalendarSpread(15) / DiagonalSpread(16) require far_expire_time. No matching spreads (including the expiry having no contracts under the current filter_standard) return ret_code=0 with spread_list=[]. Use the spread with quote.option_strategy to list combos.

Parameters ​

NameTypeInRequiredDescription
symbolstringpathyesOption underlying symbol (path param), US or HK equity/ETF. e.g. US.AAPL / HK.00700 Max length 32; Pattern ^[A-Z0-9_]+\.[A-Za-z0-9_.\-]+$
strategyintqueryyesCombo strategy type, same values as quote.option_strategy. HK does not support 2/8 Values 1, 2, 4, 6, 7, 8, 9, 11, 13, 14, 15, 16, 100
expire_timestringqueryyesNear expiry date yyyy-MM-dd, e.g. 2026-08-21 Max length 10; Pattern ^\d{4}-\d{2}-\d{2}$; Valid date YYYY-MM-DD
far_expire_timestringquerynoFar expiry date yyyy-MM-dd; required for CalendarSpread / DiagonalSpread Max length 10; Pattern ^$|^\d{4}-\d{2}-\d{2}$; Valid date YYYY-MM-DD
index_option_typeintquerynoUS index option type; required only for US index underlyings, omit for equities. HK index options have no combo strategies; do not pass 1-5
filter_standardstringquerynoFilter by standard / non-standard options; same as the expiry-date query Default "ALL"; Values ALL, STANDARD, NON_STANDARD

Example ​

bash
curl 'https://webapi.futunn.com/api/v1.0/quote/US.AAPL/option-strategy-spread?strategy=1&expire_time=value' | jq

Response ​

NameTypeDescription
dataobject
data.spread_listnumber[]Spread list
data.default_spreadnumberDefault spread; unused when spread_list is empty
paginationobjectPagination returned by some endpoints

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": {
    "spread_list": [],
    "default_spread": 1.2
  }
}