Skip to content

docs: add TaiwanStockConvertibleBondPutProvision(可轉債賣回權時程)#168

Merged
linsamtw merged 3 commits into
masterfrom
feature/taiwan-stock-convertible-bond-put-provision
Jul 26, 2026
Merged

docs: add TaiwanStockConvertibleBondPutProvision(可轉債賣回權時程)#168
linsamtw merged 3 commits into
masterfrom
feature/taiwan-stock-convertible-bond-put-provision

Conversation

@linsamtw

Copy link
Copy Markdown
Contributor

Summary

New dataset docs for TaiwanStockConvertibleBondPutProvision(可轉債賣回權時程): each convertible bond's put record date / put price / put yield rate, including announced future put dates. Data range 2011-06-22 ~ now (verified against the source). Backer/Sponsor tier.

Changes

  • ConvertibleBond.md / .en.md: new section with example / output / schema and a collapsed note about future put dates; dataset count 5 → 6
  • DataList.md / .en.md: new entry; total 86 → 87
  • WhatIsNew.md / .en.md: 2026-07-23 entry
  • llms-full.txt + llms.txt: AI-agent reference files updated

Related: financialdata !1102 / service !108 / dataflow !140 / api !725 / backend !620 / vueweb !162

🤖 Generated with Claude Code

@linsamtw

Copy link
Copy Markdown
Contributor Author

追加一版:範例原本寫成需要 "data_id": "14773",實際上不需要 —— 已改為只帶日期區間,並在 zh/en 都加上 ??? note 註明。

實測(api TestClient 打 dev redis/MySQL):

情境 減資恢復買賣參考價格 可轉債賣回權時程
免費、不帶 data_id 400 需升級 400 需升級
免費、帶 data_id 200(1 列) 400(本身限 backer)
backer、不帶 data_id 200(3 列/3 檔) 200(6 列/6 檔)
backer、帶 data_id 200(1 列) 200(1 列)

所以兩者的 data_id 都非必填,但減資的「不帶 data_id 全市場查詢」需 backer/sponsor(免費會員帶 data_id 才查得到),這點在 Fundamental.md/.en.md 的 note 有寫清楚,避免免費用戶照抄範例踩 400。

順帶:範例區間從 2011-06-01~06-30 改成 ~12-31,因為原區間實際只有 1 檔可轉債,看不出「一次回全部」;output 表格換成實際 API 回傳的 6 列。

對應 api !730、vueweb !165。

@linsamtw
linsamtw force-pushed the feature/taiwan-stock-convertible-bond-put-provision branch from 06c7f5c to e6e749e Compare July 26, 2026 14:31
@linsamtw

Copy link
Copy Markdown
Contributor Author

已 rebase 到最新 master(#169 TaiwanAssetSwapDaily 已 merge)並解掉衝突,現在是 MERGEABLE / CLEAN。

衝突內容只有 DataList.md / DataList.en.md 第一行的資料集數量(master 88 vs 本 PR 87);dataset 的清單條目本身自動合併乾淨,master 的 AssetSwap 內容也都保留。解法=master 88 + 本 PR 1 個 dataset = 89

⚠️ #165#168 都把這個數字改成 89,所以:先 merge 的那條沒問題,第二條會在同一行再撞一次衝突,屆時要改成 90。 我不猜 merge 順序,所以兩條都留在 89;第一條 merge 後告訴我,我 rebase 第二條並把數字改成 90。

(順帶:master 這行自報 88,但檔案裡實際有 90 條 - [ 條目——本來就不一致,所以我用「master 計數 +1」而不是重新數,維持既有計數慣例。)

linsamtw and others added 3 commits July 26, 2026 22:36
New dataset docs: each convertible bond's put record date / put price /
put yield rate, including announced future put dates. Data range
2011-06-22 ~ now. Backer/Sponsor.

- ConvertibleBond.md / .en.md: new section (example/output/schema +
  "includes future put dates" note admonition); dataset count 5 -> 6
- DataList.md / .en.md: new entry; total count 86 -> 87
- WhatIsNew.md / .en.md: 2026-07-23 entry (data range only)
- llms-full.txt: new dataset block; llms.txt: category list entry

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
老闆指出範例寫成需要 `"data_id": "14773"`,但實際上不需要。實測確認
(api TestClient 打 dev redis):backer token 不帶 data_id 查
2011-06-01~2011-12-31 → 200/6 列/6 檔可轉債;帶 data_id=14773 → 1 列。
減資恢復買賣參考價格同理(backer 不帶 data_id → 3 列/3 檔),差別在免費
會員不帶 data_id 會被要求升級,帶 data_id 則可查。

- ConvertibleBond.md / .en.md「可轉債賣回權時程」:
  - bullet 補「**不需帶 data_id(可轉債代碼)**,只要指定日期區間,即回傳
    該區間內所有可轉債的賣回場次」
  - 新增 `??? note "不需帶 data_id(可轉債代碼)"` 摺疊區塊(放 bullet 後、
    example 前),說明省略即回全部、要單檔仍可加 data_id
  - 三個範例(Package / Python-request / R)移除 cb_id / data_id,區間改
    2011-06-01~2011-12-31(原 06-30 區間實際只有 1 檔,看不出「回全部」)
  - output DataFrame 改用**實際 API 回傳值**的 6 列(14773 聚陽三/33833
    新世三/26033 長榮三/89331 愛地一/55123 力麒三/12251 福脂一)
  - 原「包含未來已公告場次」note 移除重複的 data_id 敘述,只講 end_date
- Fundamental.md / .en.md「減資恢復買賣參考價格」:新增
  `??? note "data_id(股票代碼)非必填"`,並註明**不帶 data_id 的全市場查詢
  限 backer/sponsor,免費會員請帶 data_id**(實測行為,不寫成無條件可省略
  以免免費用戶踩 400)
- llms-full.txt:兩個資料集的 Params 標註 data_id optional + 補 Note 行

對應:api !730(測試鎖「需帶日期」)、vueweb !165(移除可轉債代碼輸入框並在
說明註明不需輸入代碼)。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
rebase 到 #165 merged 後的 master 的兩處必要修正:

1. **計數 89 → 90**(zh/en):master 的 89 已含 #165 的資金流向,本 PR 再加
   賣回權時程 → 90。⚠️ 這次 rebase DataList **沒有產生衝突**(master 與本
   branch 都是 89,git 視為相同),所以數字會靜默維持 89 而錯掉,必須手動改。

2. **還原 en DataList 第 52 行**:該行本應是
   `- [Industry Chain Money Flow TaiwanStockIndustryChainMoneyFlow](...)`,
   目前 master 上卻是重複的標題句
   `In the Taiwan financial market, we have 89 datasets, as listed below:`。
   成因是我先前 rebase #165 時的解衝突腳本對「每個」衝突區塊都填入標題行,
   而 en 檔有兩個衝突區塊(檔首計數 + Chip 段的資金流向條目),第二個被誤填。
   已用 #165 原始 commit(6692c65)的正確文字還原(zh 檔未受影響,比對過)。

驗證:
- zh/en 各只有一句標題行;兩檔皆含 IndustryChainMoneyFlow + PutProvision 兩條
- `git diff origin/master -U0` 僅剩:計數 89→90、en 還原資金流向條目、
  兩檔新增 PutProvision 條目(本 PR 內容)
- 全檔無衝突標記;本 PR 的 data_id note(zh/en)、減資 note、WhatIsNew 兩則
  (07-23 賣回權時程 + 07-21 資金流向)皆完整

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@linsamtw
linsamtw force-pushed the feature/taiwan-stock-convertible-bond-put-provision branch from e6e749e to bd0a27c Compare July 26, 2026 14:38
@linsamtw

Copy link
Copy Markdown
Contributor Author

已 rebase 到 #165 merged 後的 master(8b3bb69),現在 MERGEABLE / CLEAN。

衝突:WhatIsNew.md / .en.md 頂端兩邊各加了一條 → 兩條都保留,按倒序排(本 PR 的 2026-07-23 賣回權時程在上、master 的 2026-07-21 資金流向在下)。

另外兩處不是衝突、但必須手動處理:

  1. DataList 計數 89 → 90:這次 DataList 沒有產生衝突(master 與本 branch 都是 89,git 視為相同內容),所以數字會靜默停在 89 而錯掉。master 的 89 已含 docs: add TaiwanStockIndustryChainMoneyFlow (台股產業鏈資金流向) #165 的資金流向,本 PR 再加賣回權時程 → 90。

  2. 修復 en DataList 第 52 行被誤刪的資金流向條目 —— 這是我造成的,先說明:我上一輪 rebase docs: add TaiwanStockIndustryChainMoneyFlow (台股產業鏈資金流向) #165 時的解衝突腳本對「每個」衝突區塊都填入標題行,而 DataList.en.md兩個衝突區塊(檔首計數 + Chip 段的資金流向條目),第二個被誤填成重複的標題句 In the Taiwan financial market, we have 89 datasets...。該錯誤已隨 docs: add TaiwanStockIndustryChainMoneyFlow (台股產業鏈資金流向) #165 進到 master,我在本 PR 用 docs: add TaiwanStockIndustryChainMoneyFlow (台股產業鏈資金流向) #165 原始 commit(6692c65)的正確文字還原。zh 檔比對過,未受影響。

驗證:

  • zh/en 各只有一句標題行;兩檔皆含 IndustryChainMoneyFlow + PutProvision 兩條
  • git diff origin/master -U0 只剩三類改動:計數 89→90、en 還原資金流向條目、兩檔新增 PutProvision 條目(本 PR 內容)
  • 全檔無衝突標記;本 PR 的 data_id note(zh/en)、減資 note 都完整

@linsamtw
linsamtw merged commit fc13f73 into master Jul 26, 2026
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.

1 participant