除權息資料

取得 上市櫃除權息資料（依日期查詢）

GET /corporate-actions/dividends/

版本資訊

v2.2.8 起新增功能

Parameters

Name	Type	Description
start_date	string	開始日期（格式：yyyy-MM-dd）
end_date	string	結束日期（格式：yyyy-MM-dd）可輸入未來日期取得未來預告資訊

Response

Name	Type	Description
data*	object[]	除權息資料
data.date*	string	除權息日期
data.exchange	string	交易所
data.symbol	string	股票代號
data.name	string	股票名稱
data.previousClose	number	除權息前收盤價
data.referencePrice	number	除權息參考價
data.dividend	number	除權息總金額 (權值 + 息值)
data.dividendType	string	除權息類別
data.limitUpPrice	number	除權後漲停價
data.limitDownPrice	number	除權後跌停價
data.openingReferencePrice	number	開盤競價參考價
data.exdividendReferencePrice	number	減除股利參考價
data.cashDividend	number	現金除息
data.stockDividendShares	number	每千股無償配股

Example

Python

from fubon_neo.sdk import FubonSDK, Order

sdk = FubonSDK()

accounts = sdk.login("Your ID", "Your password", "Your cert path", "Your cert password")  # 需登入後，才能取得行情權限

sdk.init_realtime() # 建立行情連線

reststock = sdk.marketdata.rest_client.stock

## 2.2.6 及以後版本使用更簡化 (使用 Exception 進行例外處理)
from fubon_neo.sdk import FugleAPIError

try:  
  response = reststock.corporate_actions.dividends(**{"start_date": "2025-08-26", "end_date": "2026-01-08"})
except FugleAPIError as e:
  print(f"Error: {e}")
  print("------------")
  print(f"Status Code: {e.status_code}")  # 例: 429
  print(f"Response Text: {e.response_text}")  # 例: {"statusCode":429,"message":"Rate limit exceeded"}   

print(response)

Node.js

const { FubonSDK } = require('fubon-neo');

const sdk = new FubonSDK();

const accounts = sdk.login("Your ID", "Your Password", "Your Cert Path", "Your Cert Password");

sdk.initRealtime(); // 建立行情連線
const client = sdk.marketdata.restClient
client.stock.corporateActions.dividends({ start_date: '2025-08-26', end_date: '2026-01-08' })
  .then(data => console.log(data));

C#

using FubonNeo.Sdk;
using FugleMarketData.QueryModels.Stock.CorporateActions;


var sdk = new FubonSDK();
var result = sdk.Login("Your ID", "Your Password", "Your Cert Path", "Your Cert Password");

sdk.InitRealtime();  // 建立行情連線

var rest = sdk.MarketData.RestClient.Stock;

var dividend = await rest.CorporateActions.Dividends(new()
{
    StartDate = fromDate,
    EndDate = toDate,
    Sort = SortType.Desc // Optional
});

var dividend_cont = dividend.Content.ReadAsStringAsync().Result;

Console.WriteLine(dividend_cont);

Response Body：

{
  "data": [
    { // 宣告未來的除權息資料不會帶入價格
      "date": "2026-01-08",
      "exchange": "TWSE",
      "symbol": "2247",
      "name": "汎德永業",
      "previousClose": null,
      "referencePrice": null,
      "dividend": 6.5,
      "dividendType": "息",
      "limitUpPrice": null,
      "limitDownPrice": null,
      "openingReferencePrice": null,
      "exdividendReferencePrice": null,
      "cashDividend": 6.5,
      "stockDividendShares": null
    },
    { // 已發生的除權息資料會帶入價格 (僅有息)
      "date": "2026-01-06",
      "exchange": "TWSE",
      "symbol": "00946",
      "name": "群益科技高息成長",
      "previousClose": 9.6,
      "referencePrice": 9.54,
      "dividend": 0.058,
      "dividendType": "息",
      "limitUpPrice": 10.49,
      "limitDownPrice": 8.59,
      "openingReferencePrice": 9.54,
      "exdividendReferencePrice": 9.54,
      "cashDividend": 0.058,
      "stockDividendShares": 0
    },
    { // 增資 ( 前日開盤會等於減除股利參考價或 stockDividendShares = 0 )
      "date": "2026-01-06",
      "exchange": "TWSE",
      "symbol": "2442",
      "name": "新美齊",
      "previousClose": 24.8,
      "referencePrice": 24.12,
      "dividend": 0.671598,
      "dividendType": "權",
      "limitUpPrice": 27.25,
      "limitDownPrice": 21.75,
      "openingReferencePrice": 24.8,
      "exdividendReferencePrice": 24.8,
      "cashDividend": 0,
      "stockDividendShares": 0
    },
    { // 已發生的除權息資料會帶入價格 (僅有權)
      "date": "2025-08-26",
      "exchange": "TPEx",
      "symbol": "6752",
      "name": "叡揚",
      "previousClose": 158.5,
      "referencePrice": 150.95,
      "dividend": 7.548635,
      "dividendType": "權",
      "limitUpPrice": 166,
      "limitDownPrice": 136,
      "openingReferencePrice": 151,
      "exdividendReferencePrice": 150.95,
      "cashDividend": 0,
      "stockDividendShares": 50.00706711
    },
    { // 已發生的除權息資料會帶入價格 (同時包含權息)
      "date": "2025-08-26",
      "exchange": "TPEx",
      "symbol": "4554",
      "name": "橙的",
      "previousClose": 36.95,
      "referencePrice": 32.39,
      "dividend": 4.560619,
      "dividendType": "權息",
      "limitUpPrice": 35.6,
      "limitDownPrice": 29.2,
      "openingReferencePrice": 32.4,
      "exdividendReferencePrice": 32.39,
      "cashDividend": 0.35,
      "stockDividendShares": 129.99998584
    }
  ]
}