Combo Option Spread
GET/api/v1.0/quote/{symbol}/option-strategy-spreadQuery 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
| Name | Type | In | Required | Description |
|---|---|---|---|---|
symbol | string | path | yes | Option 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_.\-]+$ |
strategy | int | query | yes | Combo 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_time | string | query | yes | Near 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_time | string | query | no | Far 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_type | int | query | no | US 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_standard | string | query | no | Filter 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' | jqResponse
| Name | Type | Description |
|---|---|---|
data | object | |
data.spread_list | number[] | Spread list |
data.default_spread | number | Default spread; unused when spread_list is empty |
pagination | object | Pagination returned by some endpoints |
Errors
| ret_code | error.code | When |
|---|---|---|
| 0 | — | Success |
| -3 | invalid_parameter | A parameter is missing or not in the allowed set |
| -7 | invalid_symbol | Symbol is not in the security master |
| -8 | unsupported | Market or instrument is outside this API |
| -9 | permission_denied | Authenticated, but without quote permission |
| -10 | no_data | Nothing is returned |
| -11 | rate_limited | Per-user rate limit |
Response example
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"spread_list": [],
"default_spread": 1.2
}
}