Skip to content

Commit debbcb3

Browse files
linsamtwclaude
andcommitted
knowledge: 補齊 6/9–7/1 新增資料集到 dataset catalog
FinMind WhatIsNew 於 6/9–7/1 陸續新增數個資料集,MCP 的 knowledge pack (datasets.md,同時是 list_datasets 與 Custom GPT knowledge 的唯一來源) 先前停在 6/5 前後、未同步。本次補齊: 新增 4 個 dataset: - TaiwanOptionVix(衍生性,Backer):臺指選擇權波動率指數 VIX,資料區間 2026-03-01 ~ now - TaiwanStockConvertibleBondMonthlyAnalysis(可轉債,Backer):可轉換公司債月份分析表,2026-05-01 ~ now - TaiwanFuturesSpreadTick(衍生性,Sponsor):期貨價差每筆成交,2026-04-27 ~ now、單日查詢 - TaiwanStockInstitutionalInvestorsBuySellWide(籌碼面,Free w/ data_id):個股三大法人買賣寬表 更新 1 個 dataset: - TaiwanStockInfoWithWarrantSummary:補述 6/15 上櫃 (TPEX) 權證標的對照涵蓋、 可用母股代碼 target_stock_id 反查、上櫃回溯至 2011-01-03 欄位/必填參數/會員層級皆對照 FinMind-Doc origin/master。catalog 由 90→94, 全測試 32 passed。openapi.yaml 未列舉個別 dataset(指向 knowledge pack),故無需改。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent 4c862c8 commit debbcb3

1 file changed

Lines changed: 33 additions & 1 deletion

File tree

knowledge/datasets.md

Lines changed: 33 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ FinMind 會員方案由低到高為 **Free → Backer → Sponsor → Sponsor Pr
3737
- **Required:** `dataset=TaiwanStockInfoWithWarrantSummary`, `data_id`, `start_date`
3838
- **Optional:** `end_date`
3939
- **Key columns:** stock_id, date, close, target_stock_id, target_close, type, exercise_ratio, fulfillment_price
40-
- **描述:** 台股權證標的對照表(含履約價、行使比例)
40+
- **描述:** 台股權證標的對照表(含履約價、行使比例);涵蓋上市 (TWSE) 與上櫃 (TPEX) 權證,可用母股代碼 `target_stock_id` 反查其對應權證(含已到期、代碼重用的歷史權證),上櫃對照歷史回溯至 2011-01-03
4141

4242
### TaiwanStockTradingDate
4343
- **Endpoint:** `/api/v4/data`
@@ -203,6 +203,14 @@ FinMind 會員方案由低到高為 **Free → Backer → Sponsor → Sponsor Pr
203203
- **Key columns:** date, stock_id, buy, name, sell
204204
- **描述:** 個股三大法人買賣超
205205

206+
### TaiwanStockInstitutionalInvestorsBuySellWide
207+
- **Endpoint:** `/api/v4/data`
208+
- **Tier:** Free(w/ data_id)
209+
- **Required:** `dataset=TaiwanStockInstitutionalInvestorsBuySellWide`, `data_id` (股票代號), `start_date`
210+
- **Optional:** `end_date`
211+
- **Key columns:** date, stock_id, Foreign_Investor_buy, Foreign_Investor_sell, Foreign_Dealer_Self_buy, Foreign_Dealer_Self_sell, Investment_Trust_buy, Investment_Trust_sell, Dealer_buy, Dealer_sell, Dealer_self_buy, Dealer_self_sell, Dealer_Hedging_buy, Dealer_Hedging_sell
212+
- **描述:** 個股三大法人買賣(寬表);與 TaiwanStockInstitutionalInvestorsBuySell 同資料,改為每交易日一列、各法人別買賣攤平成獨立欄位(免自行轉置),欄位涵蓋所有歷史分類、尚未存在的年代為 0
213+
206214
### TaiwanStockTotalInstitutionalInvestors
207215
- **Endpoint:** `/api/v4/data`
208216
- **Tier:** Free
@@ -538,6 +546,22 @@ FinMind 會員方案由低到高為 **Free → Backer → Sponsor → Sponsor Pr
538546
- **Key columns:** date, contract_month, option_id, settlement_price
539547
- **描述:** 選擇權最後結算價
540548

549+
### TaiwanFuturesSpreadTick
550+
- **Endpoint:** `/api/v4/data`
551+
- **Tier:** Sponsor
552+
- **Required:** `dataset=TaiwanFuturesSpreadTick`, `data_id` (期貨代號,如 `CAF`), `start_date` (single day)
553+
- **Optional:** (無)
554+
- **Key columns:** date, time, futures_id, contract_date, price, volume, near_price, far_price, spread_to_spread
555+
- **描述:** 期貨價差(近月/遠月)每筆成交;單次請求只提供一天資料,自 2026-04-27 起逐交易日累積(暫不含更早歷史回補)
556+
557+
### TaiwanOptionVix
558+
- **Endpoint:** `/api/v4/data`
559+
- **Tier:** Backer
560+
- **Required:** `dataset=TaiwanOptionVix`, `start_date`
561+
- **Optional:** `end_date`
562+
- **Key columns:** date, time, vix
563+
- **描述:** 臺指選擇權波動率指數(VIX);含日期、時間、波動率指數,資料區間 2026-03-01 ~ now
564+
541565
## 台股 - 即時資料
542566

543567
> 此分類所有 dataset 都需要 **Sponsor** 方案。
@@ -610,6 +634,14 @@ FinMind 會員方案由低到高為 **Free → Backer → Sponsor → Sponsor Pr
610634
- **Key columns:** cb_id, ConversionPrice, IssuanceAmount, OutstandingAmount, date
611635
- **描述:** 可轉債每日總覽(轉換價、發行 / 流通在外金額)
612636

637+
### TaiwanStockConvertibleBondMonthlyAnalysis
638+
- **Endpoint:** `/api/v4/data`
639+
- **Tier:** Backer
640+
- **Required:** `dataset=TaiwanStockConvertibleBondMonthlyAnalysis`, `start_date`
641+
- **Optional:** `data_id` (可轉債代號), `end_date`
642+
- **Key columns:** date, cb_id, cb_name, cb_name_en, custody_balance, last_month_balance, change, change_percent, issued_units, custody_accounts, pledged_units
643+
- **描述:** 可轉換公司債月份分析表(每月保管餘額、上月餘額、增減、發行單位數、保管戶數、設質單位數);資料區間 2026-05-01 ~ now
644+
613645
## 台股 - 其他
614646

615647
### TaiwanStockNews

0 commit comments

Comments
 (0)