Skip to content

v1.6.0

Choose a tag to compare

@twjackysu twjackysu released this 18 Jul 06:12
· 25 commits to main since this release
c8fffcf

新功能

TWSE 歷史查詢工具(新增 5 個)

openapi.twse.com.tw 對應的端點(例如 get_daily_market_trading_infoget_market_historical_index)實測只回傳最近約 12 個交易日的滾動視窗,無法指定過去的任意日期/月份。這 5 個新工具改抓 www.twse.com.tw/rwd/* 的網頁端點,真的支援任意過去日期:

Tool 說明
get_market_institutional_amounts_history 三大法人買賣金額統計(市場層級,非個股買賣超股數)
get_all_stocks_daily_close 指定日期全部上市股票的收盤行情(開高低收、量、本益比)
get_market_turnover_history 每日市場成交量值+加權指數收盤,任意月份
get_taiex_index_history 加權股價指數每日開高低收歷史,任意月份
get_foreign_holdings_history 指定日期全部個股的外資及陸資持股比率,可選股票代號篩選

每個工具的 docstring 都明確標註與既有同名/相似工具的差異,避免混用。

錯誤修正

  • get_market_institutional_amounts_history 上線時錯誤開放了 period(day/week/month)參數,但實測後發現三種模式的參數名稱與日期編碼完全不同(dayDate vs weekDate vs monthDate),week/month 直接回傳錯誤或非 JSON 內容。已拔除該參數,僅保留驗證過可用的單日查詢。
  • get_all_stocks_daily_close 補上遺漏的 stock_no 篩選參數(與同批其他工具一致)。

文件

  • README(中/英)、CLAUDE.md 更新 TWSE Web API 工具數量(6 → 11)。