Skip to content

v1.13.0

Latest

Choose a tag to compare

@twjackysu twjackysu released this 19 Oct 13:09
9e71d80

三大法人工具改版:個股排行可以依外資、投信、自營商排序,也可以只看買超或只看賣超;市場總額可查整週與整月累計;日期一律改為選填。工具數不變(177)。

⚠️ 預設行為變更

  • get_twse_institutional_investors_summary:預設排除權證、牛熊證(原本約 93% 的資料列是權證)。要包含權證請用 category="all"。
  • get_otc_institutional:未指定 stock_no 時,改為依三大法人合計買賣超的絕對值排序(原本依代號排列)。
  • get_market_institutional_amounts_history、get_otc_institutional_summary:金額改用「億元」顯示,買賣差額另附原始「元」。

個股排行(上市 get_twse_institutional_investors_summary、上櫃 get_otc_institutional)

  • sort_by:total(三大法人合計)、foreign(外資,含外資自營商)、trust(投信)、dealer(自營商)。
  • side:buy(只列買超)、sell(只列賣超)、abs(依絕對值混排)。
  • category:
    • 留空:不含權證,含 ETF。
    • stock:再排除 ETF。
    • etf:只看 ETF。
    • all:含權證。
    • 產業代碼:例如 24 半導體業。
  • 範例:get_twse_institutional_investors_summary(category="stock", sort_by="foreign", side="buy", limit=20) 會列出外資買超前 20 名的股票。

市場總額(上市 get_market_institutional_amounts_history、上櫃 get_otc_institutional_summary)

  • period:day、week(該週合計)、month(該月合計,當月為月初至今)。
  • 上櫃版新增 scope:stocks(上櫃股票,預設)或 all(含 ETF 等全部有價證券)。
  • 上櫃版改用櫃買中心網站資料,可查過去日期。換來源前已逐列比對最新一日,內容與原本的 openapi 完全相同。

其他

  • 三支上市工具的 date 改為選填,留空即最新交易日。
  • 工具說明清楚標示「市場層級總額」或「個股」、單位(股或億元),並互相指引該用哪一支工具。
  • 三大法人分析 prompt 的「大盤整體」改為先查市場總額,再看外資買超與賣超個股。
  • contract test 移除了不屬於介面檢查的斷言(筆數門檻、檢查今天有沒有資料等),只保留第三方介面的檢查。

Full Changelog: v1.12.0...v1.13.0