# 獲取期權波動率分析

get_option_volatility(code, query_time_period=None, hv_time_period=None)

  • 介紹

    獲取指定期權合約的隱含波動率、歷史波動率及波動率溢價分析

  • 參數

    參數 類型 說明
    code str 期權代碼
    query_time_period OptionVolatilityTimePeriodType 查詢時間週期
    hv_time_period int 歷史波動率計算週期(日)
  • 返回

    參數 類型 說明
    ret RET_CODE 介面調用結果
    data pd.DataFrame 當 ret == RET_OK 時為期權波動率資料
    str 當 ret != RET_OK,返回錯誤描述
    • DataFrame 欄位說明:

      欄位 類型 說明
      timestamp int 交易日時間戳(秒級 Unix 時間戳,當日零點)
      timestamp_str str 交易日字符串
      implied_volatility float 隱含波動率
      history_volatility float 歷史波動率
      volatility_premium float 波動率溢價
      average_impvol float 隱含波動率均值
      impvol_status OptionImpvolStatusType 波動率狀態
      analysis str 分析文案
  • Example

from moomoo import *
quote_ctx = OpenQuoteContext(host='127.0.0.1', port=11111)
ret, df = quote_ctx.get_option_volatility("US.AAPL281215C320000", query_time_period=2, hv_time_period=30)
if ret == RET_OK:
    cols = ['timestamp_str', 'implied_volatility', 'history_volatility', 'volatility_premium']
    print(df[cols].to_string(index=False))
else:
    print('error:', df)
quote_ctx.close()
1
2
3
4
5
6
7
8
9
  • Output
timestamp_str  implied_volatility  history_volatility  volatility_premium
   2026-04-13              27.813              18.977               8.836
   2026-04-14              27.656              18.962               8.694
   2026-04-15              27.726              20.782               6.944
   2026-04-16              28.069              21.013               7.056
   2026-04-17              27.796              22.088               5.708
   2026-04-20              28.054              21.931               6.123
   2026-04-21              27.897              23.194               4.703
   2026-04-22              28.276              24.300               3.976
   2026-04-23              27.951              24.296               3.655
   2026-04-24              28.056              23.676               4.380
   2026-04-27              27.917              22.985               4.932
   2026-04-28              27.942              23.011               4.931
   2026-04-29              28.269              23.022               5.247
   2026-04-30              27.630              22.312               5.318
   2026-05-01              27.576              23.741               3.835
   2026-05-04              27.919              24.078               3.841
   2026-05-05              27.308              24.778               2.530
   2026-05-06              27.746              24.850               2.896
   2026-05-07              28.198              24.886               3.312
   2026-05-08              27.719              25.285               2.434
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

介面限制

  • 每 30 秒內最多請求 30 次。
  • 僅支援期權合約代碼,不支援正股代碼。