Corporate Actions Diviends

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

GET /corporate-actions/diviends/

info

屬於 開發者 及 進階用戶 方案的專屬功能！ 基本用戶 開放體驗至 2026/2/12

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

cURL

curl -X 'GET' \
  'https://api.fugle.tw/marketdata/v1.0/stock/corporate-actions/diviends?start_date=2025-08-26&end_date=2026-01-08' \
  -H 'X-API-KEY: <YOUR_API_KEY>'

Python

from fugle_marketdata import RestClient

client = RestClient(api_key = 'YOUR_API_KEY')  # 輸入您的 API key
stock = client.stock  # Stock REST API client

stock.corporate_actions.diviends(**{"start_date": "2025-08-26", "end_date": "2026-01-08"})

Node.js

const { RestClient } = require('@fugle/marketdata');

const client = new RestClient({ apiKey: 'YOUR_API_KEY' });
client.stock.corporateActions.diviends({ start_date: '2025-08-26', end_date: '2026-01-08' })
  .then(data => console.log(data));

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
    }
  ]
}