Building an AI agent? Start with /llms.txt for the full site index.

Financials & Growth

Dividend policy

Dividend policy for listed companies, sourced from MOPS — cash and stock dividends per fiscal year with the ex-dividend date.

VerifiedSource: MOPS·Plan: pro·Cost: 2 credits·GET /v2/datasets/dividends

Overview

dividends returns one row per company per fiscal year with the declared cash and stock dividends and the ex-dividend date, sourced from MOPS. Each row carries a source role and lineage back to the MOPS filing so the payout is traceable.

Field	Type	Description
`symbol`	string	Ticker.
`fiscal_year`	string	Fiscal year the dividend is drawn from.
`cash_dividend`	number	Cash dividend per share (TWD).
`stock_dividend`	number	Stock dividend per share (shares).
`ex_dividend_date`	string	Ex-dividend date.
`source_role`	string	Canonical source role (official_mops_dividend_policy).

Coverage

Rows	9,069
Window	2015-04-17 – 2026-06-02
Grade	Verified

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/dividends?ticker=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/dividends",    params={"ticker": "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/dividends",    params={"ticker": "2330"},    headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json())

OpenAPI

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

Notes & limitations

A dividend is only final once approved and the ex-date is set: pass as_of when backtesting so proposed-but-unapproved distributions do not leak into a past date.

Request & Response

Request

curl "https://api.twmarketdata.com/v2/datasets/dividends" \  -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.
`fiscal_year`	string	Fiscal year the dividend is drawn from.
`cash_dividend`	number	Cash dividend per share (TWD).
`stock_dividend`	number	Stock dividend per share (shares).
`ex_dividend_date`	string	Ex-dividend date.
`source_role`	string	Canonical source role (official_mops_dividend_policy).

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/dividends",    params={"ticker": "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/dividends",    params={"ticker": "2330"},    headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json())