AI agent？先讀 /llms.txt 取得全站索引。
公司與事件
下市生命週期——每檔證券的上市狀態與關鍵生命週期日期，含停止買賣與下市，來源為官方 TWSE／TPEx 紀錄。
GET /v2/datasets/stock-delisting-lifecyclestock-delisting-lifecycle 為參考型資料集：每檔證券一筆生命週期紀錄，追蹤其上市狀態與狀態變更日期（上市、停止買賣、下市），來源為官方 TWSE／TPEx 紀錄。用於判斷某代碼在過去某日是否可交易；每列附來源角色與回溯上游揭露的 lineage。
| 欄位 | 型別 | 說明 |
|---|---|---|
symbol | string | 股票代碼。 |
status | string | 正規化生命週期狀態（如 listed、suspended、delisted）。 |
listing_date | string | 首次上市（櫃）日。 |
delisting_date | string | 下市（櫃）日（仍上市則為 null）。 |
reason | string | 揭露之狀態變更原因。 |
source_role | string | 正規來源角色（official_twse_delisting_lifecycle）。 |
| 列數 | 263 |
| 涵蓋起訖 | 參考資料，無時間序列 |
| 分級 | 參考 |
此為本端點的真實回應。資料列位於 "data" 之下，來源資訊如下方所示；各資料集形狀不盡相同，請以本頁為準。
{ "dataset_id": "stock_delisting_lifecycle", "request_context": { "scope": "stock_delisting_lifecycle_twse_only", "coverage_type": "twse_delisted_company_reference", "snapshot_mode": "current_snapshot_only", "filters": { "market": "TWSE", "code": null, "date_from": null, "date_to": null, "event_type": null, "source_family": null, "limit": 50 }, "min_event_date": "2018-10-01", "max_event_date": "2026-03-27" }, "quality": { "row_count": 50, "code_count": 50, "sensitive_fields_exposed": false }, "lineage": { "source_providers": [ "twse_official" ], "source_roles": [ "official_twse_delisted_company_table" ], "source_families": [ "twse_delisted_company_table" ] }, "error": null, "data": [ { "market": "TWSE", "code": "3454", "company_name": null, "event_type": "delisting", "announcement_date": null, "suspension_date": null, "delisting_date": "2026-03-27", "reason_summary": null, "source_provider": "twse_official", "source_role": "official_twse_delisted_company_table", "source_family": "twse_delisted_company_table", "source_event_ref": "TWSE:suspendListing|3454|2026-03-27", "lineage": { "source_url": "https://www.twse.com.tw/rwd/en/company/suspendListing?response=html", "source_scope": "TWSE_ONLY", "source_title": "De-listed Companies", "source_family": "twse_delisted_company_table", "source_endpoint": "company/suspendListing" }, "data_gaps": [ "company_name_missing" ] }, { "market": "TWSE", "code": "6423", "company_name": "YMC", "event_type": "delisting", "announcement_date": null, "suspension_date": null, "delisting_date": "2026-01-22", "reason_summary": null, "source_provider": "twse_official", "source_role": "official_twse_delisted_company_table", "source_family": "twse_delisted_company_table", "source_event_ref": "TWSE:suspendListing|6423|2026-01-22", "lineage": { "source_url": "https://www.twse.com.tw/rwd/en/company/suspendListing?response=html", "source_scope": "TWSE_ONLY", "source_title": "De-listed Companies", "source_family": "twse_delisted_company_table", "source_endpoint": "company/suspendListing" }, "data_gaps": [] } ], "data_count": 50, "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_delisting_lifecycle", "scope": "stock_delisting_lifecycle_twse_only", "row_count": 50 }}擷取自 2026-07-20 的線上 API。
curl "https://api.twmarketdata.com/v2/datasets/stock-delisting-lifecycle?symbol=2330" \ -H "X-API-Key: sk_live_..."| 參數 | 必填 | 型別 | 說明 |
|---|---|---|---|
symbol | 否 | string | 以股票代碼篩選單一標的。 |
limit | 否 | integer | 回傳筆數上限。 |
第一個呼叫：
import requests resp = requests.get( "https://api.twmarketdata.com/v2/datasets/stock-delisting-lifecycle", 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/stock-delisting-lifecycle", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()for row in resp.json()["data"]: print(row)此端點為 GET /v2/datasets/stock-delisting-lifecycle。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。