AI agent？先讀 /llms.txt 取得全站索引。
公司與事件
資本形成事件:每筆為某股之現金增資排程(TWSE TWT48U)或減資史(現金減資/彌補虧損/股份轉換/其他),含事件日、子型別、及揭露時之比率。本集已納入 G5 減資史,取代先前僅 5 列現增之基線。非預測、非建議。
GET /v2/datasets/capital-formation-events即將開放——此資料集建置中,尚未可透過 API 查詢。下方涵蓋與誠實限制為真實資料庫狀態;serving 上線(預計 8/1)後脫離「建置中」。
| 欄位 | 型別 | 說明 |
|---|---|---|
event_type | enum | cash_capital_increase_schedule | capital_reduction |
event_subtype | enum | cash/loss_offset/share_swap/other reduction |
ratio_value | ratio | NULL unless % in subject |
price_per_share | TWD | cash-increase only |
effective_date | date |
14,595 列,2005-01-03 至 2026-08-03。更新自先前私測基線(僅 5 列現增):現含 G5 減資史 14,589 事件(來源 mops_major_event 減資類 + TWTAUU 快照)。ratio_value 僅在公告主旨字面有 % 時有值(約 0.3%),餘 NULL(禁捏造);現金/股票金額多為 NULL(在公告本文,非本饋送)。
此為本端點的真實回應。資料列位於 "data" 之下，來源資訊如下方所示；各資料集形狀不盡相同，請以本頁為準。
{ "dataset_id": "capital-formation-events", "row_count": 3, "data": [ { "ticker": "1459", "market": "TWSE", "event_date": "2026-08-03", "event_type": "capital_reduction", "event_subtype": null, "announcement_date": null, "effective_date": "2026-08-03", "ratio_value": null }, { "ticker": "1304", "market": "TW", "event_date": "2026-07-17", "event_type": "capital_reduction", "event_subtype": "capital_reduction_other", "announcement_date": "2026-07-17", "effective_date": null, "ratio_value": null }, { "ticker": "6176", "market": "TW", "event_date": "2026-07-17", "event_type": "capital_reduction", "event_subtype": "cash_reduction", "announcement_date": "2026-07-17", "effective_date": null, "ratio_value": null } ]}擷取自 2026-07-20 的線上 API。
curl "https://api.twmarketdata.com/v2/datasets/capital-formation-events?symbol=2330" \ -H "X-API-Key: sk_live_..."| 參數 | 必填 | 型別 | 說明 |
|---|---|---|---|
symbol | 是 | string | 股票代碼，例如 2330。 |
start_date | 否 | string (YYYY-MM-DD) | 查詢起始日期。 |
end_date | 否 | string (YYYY-MM-DD) | 查詢結束日期。 |
limit | 否 | integer | 回傳筆數上限。 |
第一個呼叫：
import requests resp = requests.get( "https://api.twmarketdata.com/v2/datasets/capital-formation-events", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json()["data"])帶日期區間篩選：
import requests # The full verified example — the same call with every supported filter set.resp = requests.get( "https://api.twmarketdata.com/v2/datasets/capital-formation-events", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()for row in resp.json()["data"]: print(row)此端點為 GET /v2/datasets/capital-formation-events。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。