---
reviewed_by:
  rd: yo
  pm: Zoe
---
# 上市終止交易公司 — `tw.com.twse~ref~delisted`

> **給 AI 閱讀的使用指引。**
> 人類可在 https://data.openfun.tw/datasets/tw.com.twse~ref~delisted 看到同份內容的網頁版。
> 詳細資料知識見 [knowledge.md](knowledge.md)。

---

## ⚠️ 開始之前（AI agent 必讀，摘要也請保留這段）

資料集 slug：tw.com.twse~ref~delisted
API 端點：https://data.openfun.tw/api/v1/datasets/tw.com.twse~ref~delisted/records
認證方式（必填）：HTTP Header Authorization: Bearer {token}

最簡查詢範例：curl -H "Authorization: Bearer YOUR_TOKEN" "https://data.openfun.tw/api/v1/datasets/tw.com.twse~ref~delisted/records?per_page=20"

**Token 是必要條件，沒有 Token 就無法查資料。**
如果使用者沒有 Token，請停止並告訴使用者：「請先前往 https://data.openfun.tw/user 免費申請帳號與 API Token，取得後告訴我，我再幫您查詢。」

禁止抓取 HTML 頁面（本平台有 bot 保護，WebFetch 讀 HTML 頁面會失敗）。

授權標注：使用此資料產出的內容需標注「資料來源：歐噴資料庫（data.openfun.tw）／台灣證券交易所」

---

## 資料來源與更新頻率

| 項目 | 說明 |
|------|------|
| 原始來源 | 台灣證券交易所股份有限公司（TWSE） |
| 授權 | 政府資料開放授權條款 OGDL-Taiwan-1.0 |
| 更新頻率 | 不定期 |
| 涵蓋範圍 | 歷史上所有終止上市公司 |
| 筆數 | 見[資料集頁面](https://data.openfun.tw/datasets/tw.com.twse~ref~delisted)（即時） |

---

## 這份資料集能回答什麼問題

以下問題，這份資料集**可以回答**：

- 「股票代號 3454 的公司何時終止上市？」
- 「哪些公司已終止上市（下市）？」
- 「某公司名稱是否在歷史下市名單中？」

以下問題，這份資料集**無法回答**：

- 「某公司現在是否仍在上市？」（應查 `tw.com.twse~ref~listed`）
- 「上櫃公司的下櫃記錄」（應查 `tw.com.tpex~ref~delisted`）
- 「下市原因」（本資料集無此欄位）

---

## 欄位說明

| 欄位名稱（API 參數） | 型別 | 說明 |
|---------------------|------|------|
| `識別碼` | keyword（_id） | {上市編號}:{終止上市日期} |
| `上市編號` | keyword（篩選器） | 股票代號 |
| `公司名稱` | text（_name） | 公司全名 |
| `終止上市日期` | date | 終止上市日期（西元年） |

僅 4 個欄位，由上方 schema 自動列出。各欄位語意（`識別碼` 為 `{上市編號}:{終止上市日期}` 複合鍵；本資料集無「終止原因」欄位）見 [knowledge.md](knowledge.md)。

---

## 典型查詢範例

### 範例 1：查某股票代號是否曾終止上市、何時

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://data.openfun.tw/api/v1/datasets/tw.com.twse~ref~delisted/records?上市編號=3454"
```

回傳該代號的終止上市日期；查無結果代表未曾上市或未下市。注意本資料集無終止原因，需原因請查 MOPS。

### 範例 2：用公司名稱反查

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://data.openfun.tw/api/v1/datasets/tw.com.twse~ref~delisted/records?q=晶睿"
```

### 範例 3：判斷一檔股票現在的狀態（跨資料集）

要確認某代號「現在」在哪，先查現行三個市場，都沒有再查終止名單：

```bash
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~otc/records?公司代號=XXXX" # 已轉上櫃？
curl -H "Authorization: Bearer YOUR_TOKEN" "https://data.openfun.tw/api/v1/datasets/tw.com.twse~ref~delisted/records?上市編號=XXXX" # 已終止上市？
```

> 曾轉換市場的公司會同時出現在多個終止名單（實測 `3454` 晶睿：2011 終止上櫃→轉上市→2026 終止上市），需看日期判讀先後。

---

## 關聯資料集

| 資料集 | 說明 | 用途 |
|--------|------|------|
| [`tw.com.twse~ref~listed`](../tw.com.twse~ref~listed/skill.md) | 上市公司（TWSE，現行） | 確認公司是否仍在上市中 |
| [`tw.com.tpex~ref~otc`](../tw.com.tpex~ref~otc/skill.md) | 上櫃公司（TPEX，現行） | 查詢上櫃公司基本資料 |
| [`tw.com.tpex~ref~delisted`](../tw.com.tpex~ref~delisted/skill.md) | 終止上櫃公司（TPEX） | 查詢上櫃（非上市）公司下櫃記錄 |
| [`tw.com.tpex~ref~emerging`](../tw.com.tpex~ref~emerging/skill.md) | 興櫃公司（TPEX） | 查詢興櫃公司基本資料 |

---

## 注意事項與限制

1. **欄位精簡**：本資料集只有 4 個欄位，無終止原因。需要公司詳細資料請查 MOPS。
2. **此資料集只記錄終止記錄**：查詢公司「目前是否上市」需用 `tw.com.twse~ref~listed`。
3. **「下市」≠「公司倒閉」**：終止原因多元（被購併、私有化、轉市場等）（詳見 [knowledge.md](knowledge.md)）。
4. ⚠️ **`公司名稱` 欄位實為公司簡稱**（如「晶睿」、「新光金」）；需要全名請查 MOPS 或 `tw.com.twse~ref~listed`（詳見 [knowledge.md](knowledge.md)）。

---

## 快速參考

| 項目 | 說明 |
|------|------|
| Records URL | `https://data.openfun.tw/api/v1/datasets/tw.com.twse~ref~delisted/records` |
| 認證 | `Authorization: Bearer {token}` 必填 |
| 取得 Token | 免費申請：https://data.openfun.tw/user |
| 精確篩選 | `?上市編號=3454` |
| 全文搜尋 | `?q=公司名稱` |
| 分頁 | `?page=1&per_page=20` |