Skip to content

v1.11.0

Choose a tag to compare

@twjackysu twjackysu released this 14 Oct 12:58
b47729d

新增一組 ETF 工具,涵蓋所有投信、上市與上櫃(股票、債券、主動式 ETF)。資料全部來自官方免費來源:投信投顧公會、證交所、櫃買中心。工具數 173 → 176(新增 4 支,合併移除 1 支)。

⚠️ 不相容變更

  • 移除 get_fund_basic_info,改用 get_etf_info。舊工具只有上市基金、只能列清單。移除前已逐列比對:舊工具的 272 檔全部出現在新工具清單中,單檔查詢也包含舊工具的所有欄位。

新增工具

get_etf_info(code, issuer, category, keyword):ETF 基本資料

  • 單檔:經理公司、成立/上市日、分類、追蹤指數、配息頻率、經理人、保管機構;上櫃 ETF 另有管理費、保管費與交易規則。
  • 不指定代號時列出清單,可依投信、分類(債券、槓桿、上櫃…)、關鍵字篩選。
  • 期貨 ETF、外幣級別代號也查得到(由證交所資料補上)。

get_etf_daily_nav(code, sort_by):每日發行單位數與折溢價

  • 約 360 檔(含上櫃與期貨 ETF):已發行單位數與較前日增減(即淨申購/買回)、市價、預估淨值、折溢價、前日淨值、規模估算。
  • 盤中為投信即時預估淨值。不指定代號時可依規模、溢價、折價、申購、買回排行。

get_etf_monthly_stats(code, months, period, sort_by):每月統計

  • 2007 年起每月的基金規模與市占、淨值、受益權單位數、受益人數(自然人/法人)、申購與買回金額、定期定額扣款筆數/戶數/金額。
  • 可查單檔逐月趨勢,或單月全市場排行(規模、受益人數、淨申購、定期定額)。

get_etf_holdings(code, period, quarterly):成分股

  • 每月前十大持股(2021-08 起),或每季占淨值 1% 以上的持股(2021-09 起)。
  • 每筆列出標的名稱、代號(台股代號或國外 ISIN)、種類、占淨值比例與金額。
  • 持股資料只有基金名稱。工具先用代號找到基金,再做名稱精確比對(不做模糊比對),並處理基金改名與多幣別級別。實測非槓桿/反向型 ETF 幾乎都對得上。
  • 槓桿型、反向型 ETF 只持有期貨與現金,不在持股明細中;遇到時工具會直接說明,不會猜。

其他

  • prompt 範本加入新的 ETF 工具(高股息策略、選股、熱點監控)。
  • 每個新資料來源都有 contract test,只驗證上游介面;可用 python run_tests.py etf 單獨執行。

Full Changelog: v1.10.0...v1.11.0