Corporate actions

Corporate actions for listed companies — dividends, capital increases, splits and other structural events, normalized into one stream across TWSE / TPEx / MOPS.

ReferenceSource: TWSE / TPEx / MOPS·Plan: pro·Cost: 1 credits·GET /v2/datasets/corporate-actions

Overview

corporate-actions returns one row per action with a normalized action type and the key dates (record, ex, effective), merged from the official TWSE / TPEx / MOPS announcements. Each row carries its source role and lineage, so an action can be traced back to the exact upstream disclosure rather than taken on trust.

Field	Type	Description
`symbol`	string	Ticker.
`action_type`	string	Normalized action type (e.g. cash_dividend, capital_increase, split).
`title`	string	Action title as disclosed.
`ex_date`	string	Ex-rights / ex-dividend date.
`record_date`	string	Shareholder record date.
`source_role`	string	Canonical source role (official_twse_corporate_action).

Coverage

Rows	3
Window	2025-06-12 – 2025-09-15
Grade	Reference

Example response

TODO — no real response has been captured for this dataset yet. It needs an entitled API key, or its required parameters are not yet known. Rather than show an example nobody has observed, this section stays empty.

Getting started

Put your key in the X-API-Key header.
Add query parameters (symbol, date range, limit).
Send the request and read the returned payload.

curl "https://api.twmarketdata.com/v2/datasets/corporate-actions?symbol=2330" \  -H "X-API-Key: sk_live_..."

Filtering

Parameter	Required	Type	Description
`symbol`	Yes	string	Ticker, e.g. 2330.
`start_date`	No	string (YYYY-MM-DD)	Start of the query range.
`end_date`	No	string (YYYY-MM-DD)	End of the query range.
`limit`	No	integer	Maximum rows to return.

Python

A first call:

import requests resp = requests.get(    "https://api.twmarketdata.com/v2/datasets/corporate-actions",    params={"symbol": "2330"},    headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json())

With a date-range filter:

import requests # The full verified example — the same call with every supported filter set.resp = requests.get(    "https://api.twmarketdata.com/v2/datasets/corporate-actions",    params={"symbol": "2330"},    headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json())

OpenAPI

This endpoint is GET /v2/datasets/corporate-actions. The full machine-readable schema (parameters, security, response envelope) lives in the OpenAPI spec.

Notes & limitations

Actions are point-in-time sensitive: a proposed action is only final once approved and its ex/record dates are set — pass as_of when backtesting so unapproved actions do not leak into a past date.

Request & Response

Request

curl "https://api.twmarketdata.com/v2/datasets/corporate-actions?symbol=2330&start_date=2026-01-01&end_date=2026-06-30&limit=5" \  -H "X-API-Key: $TWMD_API_KEY"

Authenticate with the X-API-Key header, using a sk_live_ key issued in the dashboard.

Response

TODO — no response has been captured for this dataset yet (it needs an entitled key, or its required parameters are not yet known). No example is shown rather than an invented one.

The grade badge on this page is a documentation classification, not a response field.

Overview

Field	Type	Description
`symbol`	string	Ticker.
`action_type`	string	Normalized action type (e.g. cash_dividend, capital_increase, split).
`title`	string	Action title as disclosed.
`ex_date`	string	Ex-rights / ex-dividend date.
`record_date`	string	Shareholder record date.
`source_role`	string	Canonical source role (official_twse_corporate_action).

Parameter

Required

Type

Description

symbol

Yes

string

Ticker, e.g. 2330.

start_date

string (YYYY-MM-DD)

Start of the query range.

end_date

string (YYYY-MM-DD)

End of the query range.

limit

integer

Maximum rows to return.

Python

A first call:

import requests resp = requests.get(    "https://api.twmarketdata.com/v2/datasets/corporate-actions",    params={"symbol": "2330"},    headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json())

With a date-range filter:

import requests # The full verified example — the same call with every supported filter set.resp = requests.get(    "https://api.twmarketdata.com/v2/datasets/corporate-actions",    params={"symbol": "2330"},    headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json())