# 期權賣方專區

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 次期權賣方專區接口