docs: add TaiwanStockConvertibleBondPutProvision(可轉債賣回權時程)#168
Conversation
|
追加一版:範例原本寫成需要 實測(api TestClient 打 dev redis/MySQL):
所以兩者的 順帶:範例區間從 2011-06-01~06-30 改成 ~12-31,因為原區間實際只有 1 檔可轉債,看不出「一次回全部」;output 表格換成實際 API 回傳的 6 列。 對應 api !730、vueweb !165。 |
06c7f5c to
e6e749e
Compare
|
已 rebase 到最新 master(#169 TaiwanAssetSwapDaily 已 merge)並解掉衝突,現在是 MERGEABLE / CLEAN。 衝突內容只有 (順帶:master 這行自報 88,但檔案裡實際有 90 條 |
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>
e6e749e to
bd0a27c
Compare
|
已 rebase 到 #165 merged 後的 master( 衝突: 另外兩處不是衝突、但必須手動處理:
驗證:
|
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 → 6DataList.md/.en.md: new entry; total 86 → 87WhatIsNew.md/.en.md: 2026-07-23 entryllms-full.txt+llms.txt: AI-agent reference files updatedRelated: financialdata !1102 / service !108 / dataflow !140 / api !725 / backend !620 / vueweb !162
🤖 Generated with Claude Code