# 期权卖方专区

get_option_seller_screener(market, seller_type, sort_type=None, is_asc=None, filter_list=None)

  • 介绍

    获取期权卖方专区筛选列表,返回适合卖方策略(Cash Secured Put / Covered Call)的期权合约,包含收益率、行权概率等数据。

  • 参数

    参数 类型 说明
    market OptionMarket 期权市场类型
    seller_type SellerType 卖方策略类型
    sort_type SellerSortType 排序类型
    is_asc bool 是否升序
    filter_list list[SellerFilter] 筛选条件列表
  • 筛选器(SellerFilter)

    通过 SellerFilter 构造筛选条件,多个条件为 AND 关系。

    SellerFilter(indicator_type, value_list=None, interval_min=None, interval_max=None,
                 min_inclusive=True, max_inclusive=True, security_list=None)
    
    1
    2
    参数 类型 说明
    indicator_type SellerIndicatorType 筛选因子类型
    value_list list 确切值列表(枚举值或整数)
    interval_min float 区间下限
    interval_max float 区间上限
    min_inclusive bool 下限是否闭区间,默认 True
    max_inclusive bool 上限是否闭区间,默认 True
    security_list list[str] 证券代码列表
    • 筛选因子(完整枚举见 SellerIndicatorType),按筛选方式分组:

      筛选方式 用哪个参数 适用因子 语义
      security_list security_list OWNER_LIST 只看指定标的
      value_list value_list STOCK_CATEGORYPLATEEXPIRATION_TYPEOPTION_EXPIRATION_TYPESTRIKE_DATE_TIMESTAMP 命中枚举值集合
      范围 interval_min / interval_max IVIV_RANKIV_PERCENTILEVOLUMELEFT_DAYSANNUALIZED_RETURNOTM_DEGREE 落在区间内
  • 返回

    参数 类型 说明
    ret RET_CODE 接口调用结果
    data pandas.DataFrame 当 ret == RET_OK,返回筛选结果
    str 当 ret != RET_OK,返回错误描述
    • 返回 DataFrame 字段:

      字段 类型 说明
      option str 期权合约代码
      name str 期权名称
      option_type str 期权方向
      strike_price float 行权价
      strike_time str 到期日时间字符串
      strike_timestamp float 到期日时间戳(Unix 秒)
      left_days int 距到期天数
      option_price float 期权价格
      stock_price float 标的股票价格
      premium float 权利金
      otm_degree float 价外程度(%)
      iv float 隐含波动率(%)
      interval_return float 区间收益率(%)
      annualized_return float 年化收益率(%)
      itm_probability float 行权概率(%)
      striked_interval_return float 行权时区间收益率(%)
      striked_annualized_return float 行权时年化收益率(%)
      owner str 标的股票代码
  • Example

from futu import *

quote_ctx = OpenQuoteContext(host='127.0.0.1', port=11111)

# 筛选器用法引导(按需取消注释,构造后传入 filter_list,多条件为 AND 关系):
# # ① 标的列表筛选 — 只看自选标的
# f_owner = SellerFilter(SellerIndicatorType.OWNER_LIST,
#                        security_list=['US.TSLA', 'US.AAPL', 'US.NVDA'])
# # ② 确切值筛选 — ETF 标的 + 月期权
# f_category = SellerFilter(SellerIndicatorType.STOCK_CATEGORY,
#                           value_list=[StockCategory.ETF])
# f_expiry = SellerFilter(SellerIndicatorType.EXPIRATION_TYPE,
#                         value_list=[ExpirationType.MONTHLY])
# # ③ 范围筛选 — 距到期 7~30 天、价外程度 0%~15%
# f_days = SellerFilter(SellerIndicatorType.LEFT_DAYS, interval_min=7, interval_max=30)
# f_otm = SellerFilter(SellerIndicatorType.OTM_DEGREE, interval_min=0.0, interval_max=15.0)

ret, data = quote_ctx.get_option_seller_screener(
    market=OptionMarket.US_SECURITY,
    seller_type=SellerType.COVERED_CALL,
    sort_type=SellerSortType.ANNUALIZED_RETURN,
    is_asc=False
    # filter_list=[f_days, f_otm]   # 多条件 AND,传入上方构造的筛选条件
)
if ret == RET_OK:
    print(data)
else:
    print('error:', data)

quote_ctx.close()
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
  • Output
                 option                 name option_type  strike_price strike_time  strike_timestamp  left_days  option_price  stock_price  premium  otm_degree       iv  interval_return  annualized_return  itm_probability  striked_interval_return  striked_annualized_return    owner
0  US.SOXL260618C235000  SOXL 260618 235.00C        CALL         235.0  2026-06-18      1.781755e+09          3        21.850       234.68   2185.0       0.136  234.988           10.266           1074.855           45.724                   10.416                   1090.597  US.SOXL
1  US.SOXL260618C237500  SOXL 260618 237.50C        CALL         237.5  2026-06-18      1.781755e+09          3        20.675       234.68   2067.5       1.201  234.423            9.660           1011.470           43.682                   10.978                   1149.431  US.SOXL
2  US.SOXL260618C240000  SOXL 260618 240.00C        CALL         240.0  2026-06-18      1.781755e+09          3        19.250       234.68   1925.0       2.266  230.652            8.935            935.526           41.678                   11.405                   1194.071  US.SOXL
3    US.WDS260618C25000    WDS 260618 25.00C        CALL          25.0  2026-06-18      1.781755e+09          3         1.875        23.07    187.5       8.365  292.148            8.846            928.963           11.794                   17.952                   1885.177   US.WDS
4  US.SOXL260618C242500  SOXL 260618 242.50C        CALL         242.5  2026-06-18      1.781755e+09          3        18.350       234.68   1835.0       3.332  232.108            8.482            888.077           39.715                   12.097                   1266.538  US.SOXL
...
1
2
3
4
5
6
7

接口限制

  • 30 秒内最多请求 60 次期权卖方专区接口