Corporate Actions Dividends

Retrieve ex-dividend and ex-rights data (query by date)

GET /corporate-actions/dividends/

Version Note

Available since v2.2.8

Parameters

Name	Type	Description
start_date	string	Start date (format: yyyy-MM-dd)
end_date	string	End date (format: yyyy-MM-dd) Future dates are supported, allowing you to retrieve upcoming announcement information.

Response

Name	Type	Description
data*	object[]	Ex-rights and ex-dividend data
data.date*	string	Ex-rights / ex-dividend date
data.exchange	string	Exchange
data.symbol	string	Ticker symbol
data.name	string	Security name
data.previousClose	number	Closing price before ex-rights / ex-dividend
data.referencePrice	number	Ex-rights / ex-dividend reference price
data.dividend	number	Total amount of rights and dividends (rights value + dividend value)
data.dividendType	string	Dividend type
data.limitUpPrice	number	Limit-up price after ex-rights
data.limitDownPrice	number	Limit-down price after ex-rights
data.openingReferencePrice	number	Opening call-auction reference price
data.exdividendReferencePrice	number	Ex-dividend reference price (after deducting dividends)
data.cashDividend	number	Cash dividend
data.stockDividendShares	number	Stock dividend shares per 1,000 shares

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() # Establish market data connection

reststock = sdk.marketdata.rest_client.stock

## Version 2.2.6 and later using following Exception for error handling
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}")  # ex: 429
  print(f"Response Text: {e.response_text}")  # ex: {"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();  // Establish market data connection

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": [
    { // Prices will not be included for upcoming (future) ex-rights / ex-dividend events.
      "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
    },
    { // For ex-rights / ex-dividend events that have already occurred, price fields will be included (cash dividend only).
      "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
    },
    { // Capital increase (on the prior trading day, the opening reference price will equal the ex-dividend reference price, or `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
    },
    { // For ex-rights / ex-dividend events that have already occurred, price fields will be included (rights only).
      "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
    },
    { // For ex-rights / ex-dividend events that have already occurred, price fields will be included (both rights and dividends).
      "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
    }
  ]
}