EN 登入註冊

AI agent？先讀 /llms.txt 取得全站索引。

財務與成長

股利政策

Name: Dividend policy
Creator: TW Market Data
License: https://twmarketdata.com/zh-TW/legal/licensing

上市櫃公司股利政策,來源為公開資訊觀測站(MOPS)——各年度現金與股票股利及除息日。

← 股利政策資料集總覽

已驗證來源: MOPS·方案: pro·計費: 2 點·GET /v2/datasets/dividends

股利政策是台灣市場資料集,來源為 MOPS,由 TW Market Data 以 GET /v2/datasets/dividends 提供。

總覽

dividends 以 MOPS 為源,每家公司每個年度回傳一列,含宣告之現金與股票股利及除息日;每列附來源角色與回溯 MOPS 申報的 lineage,配息可追溯。

欄位	型別	說明
`ticker`	string
`market`	string
`announcement_date`	string
`cash_dividend`	number	每股現金股利(新台幣元)。
`stock_dividend`	number	每股股票股利(股)。
`ex_dividend_date`	string	除息(權)日。
`ex_rights_date`	null
`record_date`	null
`payment_date`	null
`dividend_type`	string
`fiscal_period`	null
`event_status`	string

涵蓋範圍

列數	約 29,086
涵蓋起訖	2005-05-06 – 2026-09-03
分級	已驗證
量測時間	2026-09-03取自資料集登錄表

範例回應

此為本端點的真實回應。資料列位於 "envelope.data" 之下，來源資訊如下方所示；各資料集形狀不盡相同，請以本頁為準。

{
  "api_version": "v2",
  "endpoint": "/v2/datasets/dividends",
  "request_id": "req_5ecefc741837",
  "plan_id": "enterprise",
  "dataset": "dividends",
  "query": {
    "ticker": "2330",
    "announcement_date_from": null,
    "announcement_date_to": null,
    "ex_dividend_date_from": null,
    "ex_dividend_date_to": null,
    "limit": 50,
    "offset": 0,
    "sort_by": "announcement_date",
    "sort_order": "desc"
  },
  "meta": {
    "rows_returned": 2,
    "mandatory_contract_fields_present": [
      "api_version",
      "data",
      "data_as_of"
    ],
    "plan": "enterprise",
    "row_limit": 100000,
    "is_limited": false
  },
  "envelope": {
    "api_version": "v2",
    "dataset": "dividends",
    "dataset_version": "v2.0.0-preview",
    "release_version": "v2.2026-05-12.preview",
    "release_date": "2026-05-12",
    "data_as_of": "2026-05-12",
    "request_context": {
      "ticker": "2330",
      "as_of_date": "2026-05-12",
      "family": "market_structure_corporate_actions",
      "field_group_type": "event_fact_current_snapshot",
      "dataset_view": "dividends_corporate_actions_enhanced_v1",
      "coverage_type": "current_snapshot",
      "market_scope": "TWSE",
      "historical_coverage_status": "blocked_not_proven",
      "supported_sort_by": [
        "announcement_date"
      ],
      "supported_filter_fields": [
        "ticker",
        "announcement_date_from",
        "announcement_date_to"
      ],
      "known_gaps": [
        "current_snapshot_only_no_historical_2020_2026_claim",
        "partial_ex_date_coverage",
        "security_master_gaps_preferred_special_variants=32"
      ]
    },
    "data": [
      {
        "ticker": "2330",
        "market": "TWSE",
        "announcement_date": "2026-05-12",
        "source_event_ref": "twse_dividend_snapshot|2330|115|1",
        "cash_dividend": 7,
        "stock_dividend": 0,
        "ex_dividend_date": "2026-06-11",
        "ex_rights_date": null,
        "record_date": null,
        "payment_date": null,
        "dividend_type": "cash",
        "fiscal_period": null,
        "event_status": "announced",
        "provider": "twse_official",
        "source_role": "current_snapshot_dividend_distribution",
        "lineage": {
          "data_gaps": [],
          "row_index": 288,
          "source_family": "twse_dividend_distribution_open_data_t187ap45_l",
          "joined_ex_date_source_family": "twse_exright_exdividend_schedule_twt48u_all",
          "current_snapshot_controlled_write_ts": "20260604T143239Z"
        },
        "updated_at": "2026-06-04T14:32:49.575532"
      },
      {
        "ticker": "2330",
        "market": "TWSE",
        "announcement_date": "2026-02-10",
        "source_event_ref": "twse_dividend_snapshot|2330|114|1",
        "cash_dividend": 6.000036,
        "stock_dividend": 0,
        "ex_dividend_date": "2026-06-11",
        "ex_rights_date": null,
        "record_date": null,
        "payment_date": null,
        "dividend_type": "cash",
        "fiscal_period": null,
        "event_status": "announced",
        "provider": "twse_official",
        "source_role": "current_snapshot_dividend_distribution",
        "lineage": {
          "data_gaps": [],
          "row_index": 289,
          "source_family": "twse_dividend_distribution_open_data_t187ap45_l",
          "joined_ex_date_source_family": "twse_exright_exdividend_schedule_twt48u_all",
          "current_snapshot_controlled_write_ts": "20260604T143239Z"
        },
        "updated_at": "2026-06-04T14:32:49.575532"
      }
    ],
    "quality": {
      "freshness_state": "fresh",
      "freshness_as_of": "2026-05-12",
      "completeness_ratio": 1,
      "quality_status": "ready"
    },
    "lineage": {
      "source_role": "canonical",
      "selected_source": "twse_official",
      "fallback_chain": [
        "twse_exright_exdividend_schedule_twt48u_all_optional_join"
      ],
      "policy_notes": [
        "official/public-first current snapshot",
        "twse_only_current_snapshot_boundary",
        "historical_2020_2026_not_proven"
      ]
    },
    "error": {
      "error_code": null,
      "error_message": null,
      "dataset": "dividends",
      "request_id": "read-api-13558a3a18b2",
      "blocking_gate": null
    }
  }
}

擷取自 2026-07-20 的線上 API。

出處

以下欄位會隨資料一併回傳,記錄這一列的來源。它們屬於出處而非本資料集要講的事實,因此列在這裡而不進欄位表。

source_event_refprovidersource_rolelineageupdated_at

授權與顯名

本服務部分資料取自政府資料開放平臺(data.gov.tw),依「政府資料開放授權條款-第1版」授權利用。資料提供機關:臺灣證券交易所、證券櫃檯買賣中心、臺灣期貨交易所、臺灣集中保管結算所、國家發展委員會、中央銀行、經濟部統計處、財政部關務署。本服務之加值處理、衍生計算與呈現方式由 TWMD 負責,與各資料提供機關無涉。

引用此資料集

TW Market Data. (n.d.). 股利政策 [Data set]. TW Market Data. Retrieved 2026-09-05, from https://twmarketdata.com/zh-TW/docs/api/financials/dividends

版本取自資料集自己的 as_of，不是這一頁的產生日期。沒有 as_of 的資料集就不列這個欄位，不會補一個看起來合理的值。驗證簽章

可與本資料集對齊的其他資料集。每組都標出可用來 join 的欄位,規劃跨表查詢時不必自己猜。

財務比率指標
可用 market + ticker 對齊
法人說明會行事曆
可用 market + ticker 對齊
重大訊息事件分類
可用 market + ticker 對齊
重大訊息(結構化)
可用 market + ticker 對齊
注意/處置事件
可用 market + ticker 對齊

快速開始

把你的金鑰放進 X-API-Key 標頭。
加上查詢參數（symbol、日期區間、limit）。
送出請求並讀取 envelope.data 陣列。

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

篩選參數

參數	必填	型別	說明
`ticker`	否	string	由端點自身在 envelope.request_context.supported_filter_fields 宣告。
`announcement_date_from`	否	string	由端點自身在 envelope.request_context.supported_filter_fields 宣告。
`announcement_date_to`	否	string	由端點自身在 envelope.request_context.supported_filter_fields 宣告。

Python 範例

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()["envelope"]["data"])

OpenAPI

此端點為 GET /v2/datasets/dividends。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。

備註與限制

股利須經核准且訂定除息日後方為定案:回測時請帶 as_of,避免尚未核准的擬議配發洩入過去日期。

請求與回應

請求

curl "https://api.twmarketdata.com/v2/datasets/dividends" \
  -H "X-API-Key: $TWMD_API_KEY"

回應

{
  "api_version": "v2",
  "endpoint": "/v2/datasets/dividends",
  "request_id": "req_5ecefc741837",
  "plan_id": "enterprise",
  "dataset": "dividends",
  "query": {
    "ticker": "<string>",
    "announcement_date_from": "<null>",
    "announcement_date_to": "<null>",
    "ex_dividend_date_from": "<null>",
    "ex_dividend_date_to": "<null>",
    "limit": "<number>",
    "offset": "<number>",
    "sort_by": "<string>",
    "sort_order": "<string>"
  },
  "meta": {
    "rows_returned": "<number>",
    "mandatory_contract_fields_present": "<array>",
    "plan": "<string>",
    "row_limit": "<number>",
    "is_limited": "<boolean>"
  },
  "envelope": {
    "api_version": "<string>",
    "dataset": "<string>",
    "dataset_version": "<string>",
    "release_version": "<string>",
    "release_date": "<string>",
    "data_as_of": "<string>",
    "request_context": {
      "ticker": "<string>",
      "as_of_date": "<string>",
      "family": "<string>",
      "field_group_type": "<string>",
      "dataset_view": "<string>",
      "coverage_type": "<string>",
      "market_scope": "<string>",
      "historical_coverage_status": "<string>",
      "supported_sort_by": "<array>",
      "supported_filter_fields": "<array>",
      "known_gaps": "<array>"
    },
    "data": "<array>",
    "quality": {
      "freshness_state": "<string>",
      "freshness_as_of": "<string>",
      "completeness_ratio": "<number>",
      "quality_status": "<string>"
    },
    "lineage": {
      "source_role": "<string>",
      "selected_source": "<string>",
      "fallback_chain": "<array>",
      "policy_notes": "<array>"
    },
    "error": {
      "error_code": "<null>",
      "error_message": "<null>",
      "dataset": "<string>",
      "request_id": "<string>",
      "blocking_gate": "<null>"
    }
  }
}