docs: 主動式ETF 三資料集(持股明細 + 持股異動 + 清單)合併#157
Conversation
配合 api / backend:新增 sponsor 資料集文件。 - Chip.md / Chip.en.md:新增章節(TOC + 說明 + Package/Python/R 範例 + Schema) stock_id=ETF代號、component_stock_id/component_stock_name=成份標的 - DataList.md/.en.md:新增條目 + 總數 83 -> 84 - WhatIsNew.md/.en.md:2026-07-10 資料區間 2025-05-05 ~ now - llms.txt + llms-full.txt:Chip 分類 + 完整 dataset 區塊 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
由 TaiwanStockActiveETFHolding 衍生的買賣資料集:相鄰交易日成份股持股股數 相減,得每檔主動式ETF當日買/賣了哪些成份股。sponsor 資料集文件,stack 在 TaiwanStockActiveETFHolding (PR #154) 之上。 - Chip.md / Chip.en.md:TOC 條目 + 新增章節(說明 + Package/Python/R 範例 + Schema)。欄位 date, stock_id (ETF), component_stock_id, component_stock_name, action (buy/sell), shares_change(前一有資料日 shares 差,buy 正 sell 負)。 備註申購/贖回會等比例變動成份股股數並計入 shares_change,故 shares_change 為 持股股數變化,不等於經理人主動買賣純額。 - DataList.md/.en.md:新增條目 + 總數 84 -> 85 - WhatIsNew.md/.en.md:2026-07-11 資料區間 2025-05-05 ~ now - llms.txt + llms-full.txt:Chip 分類補列 + 完整 dataset 區塊 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…change -> buy/sell 依老闆指示,將欄位由 action (buy/sell) + shares_change 改為兩欄 buy / sell, 與既有 TaiwanStockInstitutionalInvestorsBuySell 資料集的買賣用語對齊: - buy:當日買進股數(成份股股數增加量,未買則 0) - sell:當日賣出股數(成份股股數減少量、取正值,未賣則 0) 兩者皆為整數(股數無小數點),每列僅其一非 0。 - Chip.md / Chip.en.md:更新說明條列、DataFrame 範例(改為 buy/sell 兩欄、 每列僅其一非 0)、Schema(buy: int / sell: int),並保留申購/贖回 caveat (改述 buy/sell 為持股股數變化,不等於經理人主動買賣純額) - llms-full.txt:更新 Columns 說明為 buy/sell、標註每列僅其一非 0,caveat 同步 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
- market_value(市值)僅部分主動式ETF於每日投資組合逐檔揭露,未揭露者為 0, 可自行以 shares × 成份股當日收盤價估算(抽象語言,不點名個別投信) - 補註 shares 為整數 雙語(Chip.md + Chip.en.md) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
新增免費資料集 TaiwanStockActiveETFInfo(主動式ETF清單 / Taiwan Active ETF
List),比照 TaiwanStockInfo 的免費「台股總覽」寫法,涵蓋台灣掛牌主動式 ETF
(上市 TWSE + 上櫃 TPEX)清單/基本資料,來源為交易所官方清單,隨新掛牌自動
更新。欄位:date、stock_id(ETF 代號)、stock_name(ETF 名稱)、category
(ETF 分類:domestic 國內/foreign 跨國)、type(市場別:twse 上市/tpex 上櫃)。
免費 tier,anchor 沿用無 -sponsor 後綴慣例(#taiwanstockactiveetfinfo)。
修改檔案:
- docs/tutor/TaiwanMarket/Technical.md / .en.md:
* 技術面資料集數 20 → 21
* 清單新增 TaiwanStockActiveETFInfo 連結(置於 TaiwanStockInfo 之後)
* 新增完整雙語段落:欄位表 + Package / Python-request / R 三種範例
(Package 用 api.taiwan_stock_active_etf_info(),raw API 用
dataset=TaiwanStockActiveETFInfo,無需 data_id)+ DataFrame/Schema output
- docs/tutor/TaiwanMarket/DataList.md / .en.md:
* 資料集總數 83 → 84
* 技術面清單新增 TaiwanStockActiveETFInfo 連結
- docs/WhatIsNew.md / .en.md:新增 2026-07-11 更新條目
- docs/llms.txt:Taiwan Market 數量 79 → 80、DataList 80 → 81,
Technical 清單補列 TaiwanStockActiveETFInfo
- docs/llms-full.txt:Technical 20 → 21 datasets,新增 TaiwanStockActiveETFInfo
條目(Tier: Free,欄位與行為說明)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…債科目) 主動式ETF 投資組合含衍生品與現金/負債科目:賣出選擇權/期貨空方部位 shares(口數) 與 market_value 可為負;應付款項等負債科目 market_value 亦可為負。可用 asset_type 篩選(只看股票取 asset_type==stock)。雙語。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…holding' into docs/active-etf-datasets
…info' into docs/active-etf-datasets # Conflicts: # docs/WhatIsNew.en.md # docs/WhatIsNew.md # docs/llms.txt # docs/tutor/TaiwanMarket/DataList.en.md # docs/tutor/TaiwanMarket/DataList.md
- Chip.md / Chip.en.md:新增備註,說明若發行商未對外提供可取得的每日投資 組合,該檔暫無持股資料,目前為「主動貝萊德優投等 00985D」,待來源開放後補上; 此類 ETF 亦不會有對應的每日持股異動 TaiwanStockActiveETFHoldingChange - 對應生產 API 實測:00985D 於 TaiwanStockActiveETFInfo 有清單(主動貝萊德優投等), 但 TaiwanStockActiveETFHolding 目前 0 列
主動式ETF清單各處說明移除「來源為交易所官方清單,隨新主動式 ETF 掛牌自動更新」 (中英 WhatIsNew / Technical / llms-full.txt),只保留欄位說明,與前端 vueweb 一致、 不對外描述來源機關與更新機制。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
主動式ETF清單屬籌碼面,與持股明細/異動同組。將 TaiwanStockActiveETFInfo 從 Technical 移到 Chip,並置於主動式ETF每日持股明細之上: - Chip.md / Chip.en.md:新增 section(持股明細上方)+ TOC + 頁面資料集數 21→22 - Technical.md / Technical.en.md:移除 section + TOC + 頁面資料集數 21→20 - DataList(.en).md:連結由 Technical 群組移到 Chip 群組(持股明細上方) - WhatIsNew(.en).md:錨點頁面 Technical→Chip - llms.txt:dataset id 由 Technical 清單移到 Chip 清單 - llms-full.txt:條目移到 Chip 區塊(持股明細上方),Technical 21→20 / Chip 18→19 錨點 #taiwanstockactiveetfinfo 不變(heading 文字未動),僅頁面路徑改變。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
WhatIsNew 中英頂部日期標題 2026-07-11 → 2026-07-12。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
There was a problem hiding this comment.
Pull request overview
This PR consolidates documentation for three Taiwan active ETF datasets into a single change set, updating the Taiwan Market dataset index pages and the LLM-facing dataset lists to reflect the additions.
Changes:
- Added full bilingual docs sections for
TaiwanStockActiveETFInfo(free),TaiwanStockActiveETFHolding(sponsor), andTaiwanStockActiveETFHoldingChange(sponsor) in Chip pages. - Updated Taiwan Market DataList and WhatIsNew entries to include these datasets.
- Updated
llms.txt/llms-full.txtdataset listings to include the new datasets.
Reviewed changes
Copilot reviewed 8 out of 8 changed files in this pull request and generated 7 comments.
Show a summary per file
| File | Description |
|---|---|
| docs/WhatIsNew.md | Adds 2026-07-12 release notes for the new active ETF datasets. |
| docs/WhatIsNew.en.md | English version of the 2026-07-12 release notes updates. |
| docs/tutor/TaiwanMarket/DataList.md | Increments Taiwan Market dataset count and adds dataset links for the three active ETF datasets. |
| docs/tutor/TaiwanMarket/DataList.en.md | English version of DataList count/link updates. |
| docs/tutor/TaiwanMarket/Chip.md | Adds dataset links and new detailed sections for the three active ETF datasets. |
| docs/tutor/TaiwanMarket/Chip.en.md | English version of the new active ETF dataset sections and links. |
| docs/llms.txt | Updates Taiwan Market dataset counts and adds the new datasets to the Chip list for LLM indexing. |
| docs/llms-full.txt | Adds full dataset blocks for the three datasets and updates the Chip/Institutional section header count. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| - 備註:`shares`(股數)為整數;`market_value`(市值)僅**部分**主動式ETF於每日投資組合逐檔揭露,未揭露者該欄為 `0`,可自行以 `shares` 乘上成份股當日收盤價估算 | ||
| - 備註:主動式ETF 投資組合含衍生品與現金/負債科目,非僅股票。**賣出選擇權、期貨等空方部位的 `shares`(口數)與 `market_value` 可為負**;應付款項等負債科目 `market_value` 亦可為負。可用 `asset_type`(`stock`/`option`/`future`/`bond`/`cash`/`other`)篩選,例如只看純股票持股取 `asset_type == "stock"` |
| - Note: `shares` is an integer; `market_value` is disclosed per holding by **only some** active ETFs' daily portfolios — where it is not disclosed the field is `0` (you can estimate it as `shares` times the constituent's closing price). | ||
| - Note: an active ETF's portfolio includes derivatives and cash/liability line items, not only stocks. **For short derivative positions (written options, short futures) both `shares` (contracts) and `market_value` can be negative**; liability line items (e.g. payables) can also have a negative `market_value`. Use `asset_type` (`stock`/`option`/`future`/`bond`/`cash`/`other`) to filter — e.g. take `asset_type == "stock"` for equity holdings only. |
| ### Taiwan Market (82 datasets) | ||
|
|
||
| - [Taiwan DataList](https://finmind.github.io/tutor/TaiwanMarket/DataList/): Full list of 80 Taiwan datasets | ||
| - [Taiwan DataList](https://finmind.github.io/tutor/TaiwanMarket/DataList/): Full list of 82 Taiwan datasets |
| - [鉅額交易買賣日報表 TaiwanStockBlockTradingDailyReport](https://finmind.github.io/tutor/TaiwanMarket/Chip/#taiwanstockblocktradingdailyreport-sponsor) | ||
| - [鉅額交易日成交資訊 TaiwanStockBlockTrade](https://finmind.github.io/tutor/TaiwanMarket/Chip/#taiwanstockblocktrade-sponsor) | ||
| - [借貸款項擔保品餘額表 TaiwanStockLoanCollateralBalance](https://finmind.github.io/tutor/TaiwanMarket/Chip/#taiwanstockloancollateralbalance-sponsor) | ||
| - [主動式ETF清單 TaiwanStockActiveETFInfo](https://finmind.github.io/tutor/TaiwanMarket/Chip/#taiwanstockactiveetfinfo) |
…hema) 回應 Copilot review: - shares 型別 float → int(financialdata schema shares: int,備註也寫「為整數」,schema 誤植 float) - asset_type 備註值 future → futures,補上 etf / repo(對齊 schema 與 crawler 實際輸出 stock/bond/futures/option/cash/etf/repo/other) 中英各一處。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
回應 Copilot review:該區塊實際有 23 個 ### dataset 區塊(皆為相異資料集, 含本 PR 新增的 holding/change/info),原宣告 19 未隨新增同步更新。Technical 已為 20/20 正確。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
該區塊實際有 18 個相異 dataset 區塊,原宣告 17。順帶校正既有計數誤差; 至此 llms-full 各有宣告數字的分類(Technical 20 / Chip 23 / Fundamental 12 / Derivative 18 / Real-Time 4 / Convertible 5 / Others 3)皆與實際區塊數一致。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
本 PR 於籌碼面新增 3 檔主動式ETF dataset(Info/Holding/Change),intro 清單 唯一 dataset 名稱數由 21→24,但標題數只更到 22。改為正確的 24(Chip.md 中文 + Chip.en.md 英文)。
|
Thanks @copilot — went through all 7 comments. Summary of what was addressed vs. already-resolved-in-a-newer-commit: Chip.md / Chip.en.md header count (22 → 24) — Valid, fixed in f5e2c77. This PR added 3 datasets to 籌碼面 (Info/Holding/Change); the intro list has 24 unique dataset names (the TradingDailyReport/WarrantTradingDailyReport variants are the duplicates you spotted), so the header is now 24. Chip.md / Chip.en.md notes conflicting with schema ( llms-full.txt section header count (19 vs 23) — Already consistent in the current HEAD (also from the earlier commit). The llms.txt Taiwan Market count (82) vs DataList (86) — This is a pre-existing cross-file basis difference, not introduced here: the llms.txt DataList / Info placement (Chip vs Technical) — The three active-ETF datasets (Info/Holding/Change) are intentionally grouped together under 籌碼面 (Chip) across all docs (Chip.md, the llms.txt Chip line, and the llms-full Chip section) so users find them in one place. |
把三個主動式ETF資料集的文件合併成單一 PR(原 #154 / #155 / #156 → 關閉)。
內容
計數
DataList 83 → 86(+3);llms.txt Taiwan Market 79 → 82。WhatIsNew 三筆、llms/llms-full 三筆皆已合。
Review 修正(回應 Copilot)
sharesfloat → int(對齊 financialdata schema 與備註);asset_type備註值對齊實際輸出(future→futures,補etf/repo)取代並關閉 #154、#155、#156。
🤖 Generated with Claude Code