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