Skip to content

docs: 主動式ETF 三資料集(持股明細 + 持股異動 + 清單)合併#157

Open
linsamtw wants to merge 16 commits into
masterfrom
docs/active-etf-datasets
Open

docs: 主動式ETF 三資料集(持股明細 + 持股異動 + 清單)合併#157
linsamtw wants to merge 16 commits into
masterfrom
docs/active-etf-datasets

Conversation

@linsamtw

@linsamtw linsamtw commented Jul 11, 2026

Copy link
Copy Markdown
Contributor

把三個主動式ETF資料集的文件合併成單一 PR(原 #154 / #155 / #156 → 關閉)。

內容

  • 主動式ETF每日持股明細 TaiwanStockActiveETFHolding(sponsor,Chip):含 shares 為整數、market_value 部分投信未揭露為 0、shares/market_value 可為負(衍生品空方/負債科目,可用 asset_type 篩選)等備註
  • 主動式ETF每日持股異動(買賣)TaiwanStockActiveETFHoldingChange(sponsor,Chip):buy/sell 欄
  • 主動式ETF清單 TaiwanStockActiveETFInfo(free,Chip):與持股明細/異動同組,置於持股明細之上(原先放 Technical,已移至 Chip)

計數

DataList 83 → 86(+3);llms.txt Taiwan Market 79 → 82。WhatIsNew 三筆、llms/llms-full 三筆皆已合。

Review 修正(回應 Copilot)

  • 持股明細 schema shares float → int(對齊 financialdata schema 與備註);asset_type 備註值對齊實際輸出(futurefutures,補 etf/repo
  • llms-full「Chip / Institutional」區塊資料集數 → 23(含本 PR 新增三筆)

取代並關閉 #154#155#156

🤖 Generated with Claude Code

linsamtw and others added 8 commits July 10, 2026 16:48
配合 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>
…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
linsamtw and others added 4 commits July 11, 2026 23:35
- 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>

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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), and TaiwanStockActiveETFHoldingChange (sponsor) in Chip pages.
  • Updated Taiwan Market DataList and WhatIsNew entries to include these datasets.
  • Updated llms.txt / llms-full.txt dataset 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.

Comment thread docs/tutor/TaiwanMarket/Chip.md Outdated
Comment thread docs/tutor/TaiwanMarket/Chip.en.md Outdated
Comment thread docs/tutor/TaiwanMarket/Chip.md Outdated
Comment on lines +3066 to +3067
- 備註:`shares`(股數)為整數;`market_value`(市值)僅**部分**主動式ETF於每日投資組合逐檔揭露,未揭露者該欄為 `0`,可自行以 `shares` 乘上成份股當日收盤價估算
- 備註:主動式ETF 投資組合含衍生品與現金/負債科目,非僅股票。**賣出選擇權、期貨等空方部位的 `shares`(口數)與 `market_value` 可為負**;應付款項等負債科目 `market_value` 亦可為負。可用 `asset_type`(`stock`/`option`/`future`/`bond`/`cash`/`other`)篩選,例如只看純股票持股取 `asset_type == "stock"`
Comment thread docs/tutor/TaiwanMarket/Chip.en.md Outdated
Comment on lines +3067 to +3068
- 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.
Comment thread docs/llms.txt
Comment on lines +54 to +56
### 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
Comment thread docs/llms-full.txt Outdated
- [鉅額交易買賣日報表 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)
linsamtw and others added 4 commits July 12, 2026 16:02
…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 英文)。
@linsamtw

Copy link
Copy Markdown
Contributor Author

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 (shares float, asset_type future, missing etf/repo) — Already resolved in the current HEAD; the review ran on an earlier commit (9acedab). The current note and schema both use shares: int and asset_type (stock/bond/futures/option/cash/etf/repo/other). Verified against the live production API: shares is returned as an integer, and the observed asset_type universe is {stock, bond, futures, etf, repo}.

llms-full.txt section header count (19 vs 23) — Already consistent in the current HEAD (also from the earlier commit). The Chip / Institutional section header now reads 23 and there are exactly 23 ### dataset blocks in it; Technical is 20/20 as well.

llms.txt Taiwan Market count (82) vs DataList (86) — This is a pre-existing cross-file basis difference, not introduced here: the llms.txt Taiwan Market (N) summary has historically run a few lower than DataList's full count (the llms-full section blocks sum to 85, DataList counts 86, llms.txt summarizes 82 — three different scopes). This PR incremented each file's existing counter consistently (+3: llms 79→82, DataList 83→86). A full cross-file count reconciliation is a separate cleanup and out of scope for this dataset PR, so I've kept the existing convention intact rather than risk a wrong "fix".

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. TaiwanStockActiveETFInfo is free even though it sits in the Chip group. The "Technical" wording in the PR description was imprecise — the docs are internally consistent on Chip.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants