Skip to content

建立 2026-09-15 更新 2026-09-15

股利、分割與選擇權

公司行動（corporate actions）會改寫歷史價格的意義；選擇權鏈則是另一組市場資料。兩者都掛在同一個 Ticker 上。

本頁說明股利、分割、資本利得，以及如何讀買權／賣權鏈。價格是否已還原，仍由 history(..., auto_adjust=...) 決定，見 歷史價量。

股利與分割

import yfinance as yf

aapl = yf.Ticker("AAPL")

aapl.dividends      # 歷年現金股利
aapl.splits         # 股票分割
aapl.actions        # 股利與分割合在一張表
aapl.capital_gains  # 基金／部分標的的資本利得配發

對應方法可指定 period，例如 get_dividends(period="max")。yf.download(..., actions=True) 會把股利與分割併進多檔價量表。

做報酬計算時：

  • auto_adjust=True：OHLC 已含股利與分割效果，比較像總報酬路徑。
  • auto_adjust=False：保留原始成交價，另有 Adj Close；股利事件要自己處理。

選擇權

options 是到期日字串的 tuple。指定某一天再拆買權、賣權：

expiries = aapl.options
chain = aapl.option_chain(expiries[0])
calls = chain.calls
puts = chain.puts

回傳的 DataFrame 通常含履約價、買價、賣價、最後成交、未平倉等。沒有選擇權的標的（許多台股）options 會是空的，不要假設每檔都能跑這段。

if aapl.options:
    calls = aapl.option_chain(aapl.options[0]).calls

持股與內部人（補充）

同一物件上還有機構持股、內部人交易等，需要時再取，不必每次都打：

aapl.institutional_holders
aapl.major_holders
aapl.insider_transactions

官方屬性列表見 Ticker。

NeuralNine 的 crash course 後段有選擇權鏈與 ETF 產業權重示範，見 首頁 或 影音教學。