--- reviewed_by: rd: yo pm: Zoe --- # 上櫃終止交易公司 — `tw.com.tpex~ref~delisted` > **給 AI 閱讀的使用指引。** > 人類可在 https://data.openfun.tw/datasets/tw.com.tpex~ref~delisted 看到同份內容的網頁版。 > 詳細資料知識見 [knowledge.md](knowledge.md)。 --- ## ⚠️ 開始之前（AI agent 必讀，摘要也請保留這段） 資料集 slug：tw.com.tpex~ref~delisted API 端點：https://data.openfun.tw/api/v1/datasets/tw.com.tpex~ref~delisted/records 認證方式（必填）：HTTP Header Authorization: Bearer {token} 最簡查詢範例：curl -H "Authorization: Bearer YOUR_TOKEN" "https://data.openfun.tw/api/v1/datasets/tw.com.tpex~ref~delisted/records?per_page=20" **Token 是必要條件，沒有 Token 就無法查資料。** 如果使用者沒有 Token，請停止並告訴使用者：「請先前往 https://data.openfun.tw/user 免費申請帳號與 API Token，取得後告訴我，我再幫您查詢。」 禁止抓取 HTML 頁面（本平台有 bot 保護，WebFetch 讀 HTML 頁面會失敗）。 授權標注：使用此資料產出的內容需標注「資料來源：歐噴資料庫（data.openfun.tw）／財團法人中華民國證券櫃檯買賣中心」 --- ## 資料來源與更新頻率 | 項目 | 說明 | |------|------| | 原始來源 | 財團法人中華民國證券櫃檯買賣中心（TPEX） | | 授權 | 政府資料開放授權條款 OGDL-Taiwan-1.0 | | 更新頻率 | 不定期 | | 涵蓋範圍 | 歷史上所有終止上櫃公司 | | 筆數 | 見[資料集頁面](https://data.openfun.tw/datasets/tw.com.tpex~ref~delisted)（即時） | --- ## 這份資料集能回答什麼問題 以下問題，這份資料集**可以回答**： - 「股票代號 4987 的公司何時終止上櫃？」 - 「哪些公司已終止上櫃？」 - 「某公司終止上櫃引用哪條法規？」（注意：約半數記錄此欄為空，且填的是法條條號非白話原因） 以下問題，這份資料集**無法回答**： - 「某公司現在是否仍在上櫃？」（應查 `tw.com.tpex~ref~otc`） - 「上市公司的下市記錄」（應查 `tw.com.twse~ref~delisted`） --- ## 欄位說明 | 欄位名稱（API 參數） | 型別 | 說明 | |---------------------|------|------| | `識別碼` | keyword（_id） | {股票代號}:{終止上櫃日期} | | `股票代號` | keyword（篩選器） | 股票代號 | | `公司簡稱` | text（_name） | 公司簡稱 | | `公司名稱` | text | 公司全名 | | `終止上櫃日期` | date | 終止上櫃日期（西元年） | | `終止上櫃原因` | keyword（篩選器） | 終止上櫃原因 | | `公司資料網址` | text | 公司資料網址 | 7 個欄位由上方 schema 自動列出。各欄位語意與陷阱（`識別碼` 為 `{股票代號}:{終止上櫃日期}` 複合鍵、`公司資料網址` 是無用的固定值）見 [knowledge.md](knowledge.md)。 --- ## 典型查詢範例 ### 範例 1：查某股票代號是否曾終止上櫃、何時、原因 ```bash curl -H "Authorization: Bearer YOUR_TOKEN" \ "https://data.openfun.tw/api/v1/datasets/tw.com.tpex~ref~delisted/records?股票代號=4987" ``` 回傳該代號的終止上櫃日期；同一代號可能有多筆（同公司多次下櫃，或不同公司沿用同代號，如 `4801`）。需以 `公司名稱`＋`終止上櫃日期` 判讀，勿只靠代號。 ### 範例 2：用公司名稱反查 ```bash curl -H "Authorization: Bearer YOUR_TOKEN" \ "https://data.openfun.tw/api/v1/datasets/tw.com.tpex~ref~delisted/records?q=科誠" ``` ### 範例 3：判斷一檔股票現在的狀態（跨資料集） 要確認某代號「現在」在哪，先查現行三個市場，都沒有再查終止名單： ```bash curl -H "Authorization: Bearer YOUR_TOKEN" "https://data.openfun.tw/api/v1/datasets/tw.com.tpex~ref~otc/records?公司代號=XXXX" # 仍在上櫃？ curl -H "Authorization: Bearer YOUR_TOKEN" "https://data.openfun.tw/api/v1/datasets/tw.com.twse~ref~listed/records?公司代號=XXXX" # 已轉上市？ curl -H "Authorization: Bearer YOUR_TOKEN" "https://data.openfun.tw/api/v1/datasets/tw.com.tpex~ref~delisted/records?股票代號=XXXX" # 已終止上櫃？ ``` > 曾轉換市場的公司會同時出現在多個終止名單（實測 `3454` 晶睿:2011 終止上櫃→轉上市→2026 終止上市），需看日期判讀先後。 ### 範例 4：依終止原因盤點 ```bash # 各終止上櫃原因的家數分布 curl -H "Authorization: Bearer YOUR_TOKEN" \ "https://data.openfun.tw/api/v1/datasets/tw.com.tpex~ref~delisted/agg?group_by=終止上櫃原因" # 篩選特定原因的公司 curl -H "Authorization: Bearer YOUR_TOKEN" \ "https://data.openfun.tw/api/v1/datasets/tw.com.tpex~ref~delisted/records?終止上櫃原因={原因字串}&per_page=20" ``` > ⚠️ 此欄位品質：約半數記錄為空字串；非空值為法條條號，且同一條文有含/不含尾端空白的多種寫法。精確篩選前需自行去空白正規化，分組數字勿直接當「原因類別數」。 --- ## 關聯資料集 | 資料集 | 說明 | 用途 | |--------|------|------| | [`tw.com.twse~ref~listed`](../tw.com.twse~ref~listed/skill.md) | 上市公司（TWSE，現行） | 查詢上市公司基本資料 | | [`tw.com.twse~ref~delisted`](../tw.com.twse~ref~delisted/skill.md) | 終止上市公司（TWSE） | 查詢上市（非上櫃）公司下市記錄 | | [`tw.com.tpex~ref~otc`](../tw.com.tpex~ref~otc/skill.md) | 上櫃公司（TPEX，現行） | 確認公司是否仍在上櫃中 | | [`tw.com.tpex~ref~emerging`](../tw.com.tpex~ref~emerging/skill.md) | 興櫃公司（TPEX） | 上櫃前置階段 | --- ## 注意事項與限制 1. **識別碼為複合鍵**：同一股票代號可能有多筆記錄（如公司曾下櫃後重新上市再下櫃）。 2. **此資料集只記錄終止記錄**：查詢公司「目前是否上櫃」需用 `tw.com.tpex~ref~otc`。 3. **「下櫃」≠「公司倒閉」**：終止原因多元（被購併、私有化、轉市場等）（詳見 [knowledge.md](knowledge.md)）。 4. **`公司簡稱` 為衍生欄位**：原始 TPEX 無此欄，由歐噴 join 補入。嚴格比對請用 `公司名稱`。 --- ## 快速參考 | 項目 | 說明 | |------|------| | Records URL | `https://data.openfun.tw/api/v1/datasets/tw.com.tpex~ref~delisted/records` | | 認證 | `Authorization: Bearer {token}` 必填 | | 取得 Token | 免費申請：https://data.openfun.tw/user | | 精確篩選 | `?股票代號=4987`、`?終止上櫃原因=XXX` | | 全文搜尋 | `?q=公司名稱` | | 分頁 | `?page=1&per_page=20` |