> For the complete documentation index, see [llms.txt](https://touchance-1.gitbook.io/touchance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://touchance-1.gitbook.io/touchance/multicharts/xuan-ze-quan.md).

# 選擇權

轉換規則

| 項目   | TCore API 格式        | MultiCharts 格式  |
| ---- | ------------------- | --------------- |
| 商品類別 | `TC.O`              | 不顯示             |
| 交易所  | `TWF`               | 移到最後            |
| 商品系列 | `TXO`、`TX2`、`TXV` 等 | 保留              |
| 到期年月 | `202609`            | `2609`          |
| 買賣權別 | `C` 或 `P`           | 與履約價合併          |
| 履約價  | `21800`             | 接在 `C` 或 `P` 後面 |

### 範例

<table><thead><tr><th width="198">說明</th><th>Python API 商品代碼</th><th>MultiCharts 商品代碼</th></tr></thead><tbody><tr><td>台指選擇權月選 Call</td><td><code>TC.O.TWF.TXO.202609.C.21800</code></td><td><code>TXO.2609.C21800.TWF</code></td></tr><tr><td>台指選擇權月選 Put</td><td><code>TC.O.TWF.TXO.202609.P.23000</code></td><td><code>TXO.2609.P23000.TWF</code></td></tr><tr><td>台指週三選 W2 Call</td><td><code>TC.O.TWF.TX2.202609.C.40600</code></td><td><code>TX2.2609.C40600.TWF</code></td></tr><tr><td>台指週五選 F2 Call</td><td><code>TC.O.TWF.TXV.202609.C.41300</code></td><td><code>TXV.2609.C41300.TWF</code></td></tr></tbody></table>

### 商品系列說明

| 商品系列  | 說明       |
| ----- | -------- |
| `TXO` | 台指選擇權月選  |
| `TX1` | 台指週三選 W1 |
| `TX2` | 台指週三選 W2 |
| `TX4` | 台指週三選 W4 |
| `TX5` | 台指週三選 W5 |
| `TXU` | 台指週五選 F1 |
| `TXV` | 台指週五選 F2 |
| `TXX` | 台指週五選 F3 |
| `TXY` | 台指週五選 F4 |
| `TXZ` | 台指週五選 F5 |

注意：週三選沒有 `TX3`，通常第 3 個週三為月選 `TXO`。週五選為 `TXU/TXV/TXX/TXY/TXZ`，沒有 `TXW`。

###

### 週五選要抓哪一個

週五選不是固定都用同一個商品系列，需依「該到期日是當月第幾個星期五」判斷。

<table><thead><tr><th width="160">到期週別</th><th width="52">商品系列</th><th width="210">MultiCharts 格式範例</th><th>Python API 格式範例</th></tr></thead><tbody><tr><td>第 1 個星期五 F1</td><td><code>TXU</code></td><td><code>TXU.2609.C45700.TWF</code></td><td><code>TC.O.TWF.TXU.202609.C.45700</code></td></tr><tr><td>第 2 個星期五 F2</td><td><code>TXV</code></td><td><code>TXV.2609.C45700.TWF</code></td><td><code>TC.O.TWF.TXV.202609.C.45700</code></td></tr><tr><td>第 3 個星期五 F3</td><td><code>TXX</code></td><td><code>TXX.2609.C45700.TWF</code></td><td><code>TC.O.TWF.TXX.202609.C.45700</code></td></tr><tr><td>第 4 個星期五 F4</td><td><code>TXY</code></td><td><code>TXY.2609.C45700.TWF</code></td><td><code>TC.O.TWF.TXY.202609.C.45700</code></td></tr><tr><td>第 5 個星期五 F5</td><td><code>TXZ</code></td><td><code>TXZ.2609.C45700.TWF</code></td><td><code>TC.O.TWF.TXZ.202609.C.45700</code></td></tr></tbody></table>

例如：2026/08/31 要查 2026/09/04 到期的週五選，因為 2026/09/04 是 9 月第 1 個星期五，所以要使用 `TXU.2609`。

```
TXU.2609.C45700.TWF
```

對應 Python API：

```
TC.O.TWF.TXU.202609.C.45700
```

| 欄位       | 意義             |
| -------- | -------------- |
| `TXO`    | 台指選擇權月選        |
| `2609`   | 2026 年 09 月到期  |
| `C21800` | Call，履約價 21800 |
| `TWF`    | 交易所            |

### 在 MultiCharts 如何查詢

1. 開啟 QuoteManager 或商品查詢視窗。
2. 搜尋商品系列，例如 `TXO`、`TX2`、`TXV`。
3. 從清單中選擇實際掛牌的履約價商品。
4. 加入商品後，即可在 MultiCharts 圖表或報價中使用。

MultiCharts 中請使用下列格式：

```
TXO.2609.C21800.TWF
TXO.2609.P23000.TWF
TX2.2609.C40600.TWF
TXV.2609.C41300.TWF
```

不要直接輸入 API 格式：

```
TC.O.TWF.TXO.202609.C.21800
```

### 在 TCore API 如何查詢

若是使用 TCore API 查詢選擇權商品，則使用完整 API 商品代碼，例如：

```
TC.O.TWF.TXO.202609.C.21800
```

若要查詢目前可用的選擇權合約清單，請使用：

```
query_all_instruments("Opt")
```

注意：類型參數請使用 `"Opt"`，不是 `"Options"`。

###

### 常見問題

#### Q1：為什麼 API 看到的商品代碼不能直接放到 MultiCharts？

因為 API 與 MultiCharts 使用不同的商品代碼格式。API 使用完整分段格式，例如 `TC.O.TWF.TXO.202609.C.21800`；MultiCharts 使用商品查詢格式，例如 `TXO.2609.C21800.TWF`。

#### Q2：API 的 `TC.O.TWF.TXO.202609.C.21800` 要怎麼轉成 MultiCharts？

轉成：

```
TXO.2609.C21800.TWF
```

規則是移除 `TC.O`，將 `TWF` 移到最後，`202609` 改成 `2609`，再把 `C` 與 `21800` 合併成 `C21800`。

#### Q3：MultiCharts 的 `TX2.2609.C40600.TWF` 對應 API 是什麼？

對應：

```
TC.O.TWF.TX2.202609.C.40600
```

#### Q4：要查月選、週選，商品系列要怎麼選？

月選使用 `TXO`。

週三選使用 `TX1/TX2/TX4/TX5`。

週五選使用 `TXU/TXV/TXX/TXY/TXZ`。

#### Q5：為什麼上週五的 `TXY.2608.C46200.TWF` 結算後顯示 No Data？

`TXY.2608` 是 2026/08/28 到期的週五選 F4，已於 2026/08/28 13:30 結算下市。客戶若在 15:00 之後的夜盤時段才加入報價頁，該契約已停止交易，當下時段不會再有即時報價，因此報價視窗顯示 `No Data` 屬正常現象。

若要回看結算前走勢，請用圖表開啟該商品，並將資料區間指定到 2026/08/28 日盤，例如 08:45 至 13:30。已結算契約不再有即時報價，但若主機保留歷史資料，仍可用圖表回看。

#### Q6：商品查詢搜到 `U_TWF.TXY` 可以選嗎？

不建議選取。`U_TWF` 是系統內部計算用的合成商品，不是期交所實際掛牌的選擇權契約。MultiCharts 交易所清單沒有 `U_TWF`，選取時可能出現「交易所列表裡找不到對應的交易所」。

查實際選擇權請使用 `TWF` 交易所的商品，例如：

```
TXU.2609.C45700.TWF
TXO.2609.C45700.TWF
```