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

公司與事件

股票分割／面額事件

Name: Stock split & par-value events
Creator: TW Market Data
License: https://twmarketdata.com/zh-TW/legal/licensing

上市櫃證券的股票分割與面額變更事件——變更前後面額、分割比例與生效日，來源為官方 TWSE／TPEx 公告。

← 股票分割／面額事件資料集總覽

已驗證來源: TWSE / TPEx·方案: free·計費: 1 點·GET /v2/datasets/stock-split-par-value-events

股票分割／面額事件是台灣市場資料集,來源為 TWSE / TPEx,由 TW Market Data 以 GET /v2/datasets/stock-split-par-value-events 提供。

總覽

stock-split-par-value-events 每筆分割或面額變更回傳一列，含變更前後面額、換股比例與生效日，來源為官方 TWSE／TPEx 公告。每列附來源角色與 lineage，事件可回溯到上游原始揭露。

欄位	型別	說明
`market`	string
`security_code`	string
`security_type`	string
`event_type`	string	正規化事件類型（如 split、par_value_change）。
`event_date`	string
`announcement_date`	null
`suspend_trading_date`	null
`resume_trading_date`	string
`par_value_before`	null
`par_value_after`	null
`par_value_ratio`	null
`closing_price_on_last_trading_day`	number
`reference_price`	number
`limit_up_price`	number
`limit_down_price`	number
`opening_reference_price`	number

涵蓋範圍

列數	6
涵蓋起訖	2026-01-09 – 2026-09-07
分級	已驗證
量測時間	2026-09-04取自資料集登錄表

範例回應

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

{
  "dataset_id": "stock_split_par_value_events",
  "request_context": {
    "scope": "stock_split_par_value_events_twse_only",
    "coverage_type": "twse_split_par_value_reference",
    "snapshot_mode": "current_snapshot_only",
    "filters": {
      "market": "TWSE",
      "security_code": "7780",
      "date_from": null,
      "date_to": null,
      "event_type": null,
      "source_family": null,
      "limit": 50
    },
    "min_event_date": "2026-01-09",
    "max_event_date": "2026-01-19"
  },
  "quality": {
    "row_count": 2,
    "security_code_count": 1,
    "sensitive_fields_exposed": false
  },
  "lineage": {
    "source_providers": [
      "twse_official"
    ],
    "source_roles": [
      "official_twse_par_value_change_announcement",
      "official_twse_par_value_change_reference_price"
    ],
    "source_families": [
      "twse_change_of_par_value",
      "twse_reference_price_after_par_value_change"
    ]
  },
  "error": null,
  "data": [
    {
      "market": "TWSE",
      "security_code": "7780",
      "security_type": "stock",
      "event_type": "split_reference_price",
      "event_date": "2026-01-19",
      "announcement_date": null,
      "suspend_trading_date": null,
      "resume_trading_date": "2026-01-19",
      "par_value_before": null,
      "par_value_after": null,
      "par_value_ratio": null,
      "closing_price_on_last_trading_day": 185,
      "reference_price": 18.5,
      "limit_up_price": 20.35,
      "limit_down_price": 16.65,
      "opening_reference_price": 18.5,
      "source_provider": "twse_official",
      "source_role": "official_twse_par_value_change_reference_price",
      "source_family": "twse_reference_price_after_par_value_change",
      "source_event_ref": "TWSE:TWTB8U|7780|2026-01-19",
      "lineage": {
        "source_url": "https://www.twse.com.tw/rwd/en/change/TWTB8U?response=json",
        "source_family": "twse_reference_price_after_par_value_change",
        "official_fields": [
          "Resume Trading Date",
          "Security Code",
          "Closing Price on The Last Trading Day"
        ],
        "source_row_type": "reference_price"
      },
      "data_gaps": [
        "announcement_date_missing"
      ]
    },
    {
      "market": "TWSE",
      "security_code": "7780",
      "security_type": "stock",
      "event_type": "par_value_change",
      "event_date": "2026-01-09",
      "announcement_date": null,
      "suspend_trading_date": "2026-01-09",
      "resume_trading_date": "2026-01-19",
      "par_value_before": 10,
      "par_value_after": 1,
      "par_value_ratio": 10,
      "closing_price_on_last_trading_day": 185,
      "reference_price": 18.5,
      "limit_up_price": 20.35,
      "limit_down_price": 16.65,
      "opening_reference_price": 18.5,
      "source_provider": "twse_official",
      "source_role": "official_twse_par_value_change_announcement",
      "source_family": "twse_change_of_par_value",
      "source_event_ref": "TWSE:TWTB7U|7780|2026-01-09|2026-01-19",
      "lineage": {
        "source_urls": {
          "TWTB7U": "https://www.twse.com.tw/rwd/en/change/TWTB7U?response=json",
          "TWTB8U": "https://www.twse.com.tw/rwd/en/change/TWTB8U?response=json"
        },
        "source_family": "twse_change_of_par_value",
        "official_fields": [
          "Suspend Trading Date",
          "Security Code",
          "Resume Trading Date"
        ],
        "source_row_types": [
          "announcement",
          "reference_price"
        ],
        "reference_price_source": "TWTB8U"
      },
      "data_gaps": [
        "announcement_date_missing"
      ]
    }
  ],
  "data_count": 2,
  "known_gaps": [
    "twse_only_scope",
    "no_tpex_coverage",
    "no_unified_security_lifecycle_claim"
  ],
  "warnings": [
    "not_investment_advice",
    "twse_only_scope"
  ],
  "not_investment_advice": true,
  "envelope": {
    "dataset_id": "stock_split_par_value_events",
    "scope": "stock_split_par_value_events_twse_only",
    "row_count": 2
  }
}

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

出處

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

source_providersource_rolesource_familysource_event_reflineagedata_gaps

授權與顯名

本服務部分資料取自政府資料開放平臺(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/companies-events/stock-split-par-value-events

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

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

注意/處置事件
可用 event_date + market + ticker 對齊
資本形成事件(增/減資)
可用 event_date + market + ticker 對齊
重大訊息事件分類
可用 event_date + market + ticker 對齊
重大訊息(結構化)
可用 event_date + market + ticker 對齊
公司新聞
可用 market + ticker 對齊

快速開始

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

curl "https://api.twmarketdata.com/v2/datasets/stock-split-par-value-events?security_code=7780" \
  -H "X-API-Key: sk_live_..."

篩選參數

參數	必填	型別	說明
`symbol`	是	string	股票代碼，例如 2330。
`start_date`	否	string (YYYY-MM-DD)	查詢起始日期。
`end_date`	否	string (YYYY-MM-DD)	查詢結束日期。
`limit`	否	integer	回傳筆數上限。

Python 範例

import requests

resp = requests.get(
    "https://api.twmarketdata.com/v2/datasets/stock-split-par-value-events",
    params={"security_code": "7780"},
    headers={"X-API-Key": "sk_live_..."},
)
resp.raise_for_status()
print(resp.json()["data"])

OpenAPI

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

備註與限制

面額與分割事件改變股本基準：與原始價格序列串接時，請以生效日對齊，使事件前後價格於同一基準比較。

請求與回應

請求

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

回應

{
  "dataset_id": "stock_split_par_value_events",
  "quality": {
    "row_count": "<number>",
    "security_code_count": "<number>",
    "sensitive_fields_exposed": "<boolean>"
  },
  "error": null,
  "data": [
    {
      "market": "<string>",
      "security_code": "<string>",
      "security_type": "<string>",
      "event_type": "<string>",
      "event_date": "<string>",
      "announcement_date": "<null>",
      "suspend_trading_date": "<null>",
      "resume_trading_date": "<string>",
      "par_value_before": "<null>",
      "par_value_after": "<null>",
      "par_value_ratio": "<null>",
      "closing_price_on_last_trading_day": "<number>",
      "reference_price": "<number>",
      "limit_up_price": "<number>",
      "limit_down_price": "<number>",
      "opening_reference_price": "<number>",
      "source_provider": "<string>",
      "source_role": "<string>",
      "source_family": "<string>",
      "source_event_ref": "<string>",
      "lineage": {
        "source_url": "<string>",
        "source_family": "<string>",
        "official_fields": "<array>",
        "source_row_type": "<string>"
      },
      "data_gaps": "<array>"
    }
  ],
  "data_count": 2,
  "known_gaps": [
    "<string>"
  ],
  "warnings": [
    "<string>"
  ],
  "not_investment_advice": true,
  "envelope": {
    "dataset_id": "<string>",
    "scope": "<string>",
    "row_count": "<number>"
  }
}