如何查三大法人籌碼

查一檔股票每日的外資／投信／自營淨買賣超,再算連續買超天數。

目標

抓一檔股票每日的三大法人籌碼——外資、投信、自營各淨買或淨賣多少。來源為官方 TWSE T86 報表,屬 Starter 方案。

步驟 1 — 取得金鑰

在儀表板核發 API 金鑰,每次請求都在 X-API-Key 標頭帶上。

步驟 2 — 請求單檔籌碼

以 symbol 與日期範圍篩選。以下是台積電（2330）的真實請求:

curl -H "X-API-Key: sk_live_..." \  "https://api.twmarketdata.com/v2/datasets/institutional-flow?symbol=2330&start_date=2026-07-14&end_date=2026-07-18"

步驟 3 — 讀回應

真實 200 回應（顯示一列,2330 於 2026-07-17）。信封為 { dataset, count, rows }:

{  "dataset": "institutional_flow",  "count": 4,  "rows": [    {      "symbol": "2330",      "date": "2026-07-17",      "foreign_net_buy_sell": -44183964.0,      "investment_trust_net_buy_sell": 1488520.0,      "dealer_net_buy_sell": 2759348.0,      "total_institutional_net_buy_sell": -39936096.0,      "source_role": "official_twse_t86",      "lineage": { "endpoint_name": "T86", "source_authority": "TWSE T86", "payload_date": "20260717" }    }  ]}

你要看的欄位

foreign_net_buy_sell — 外資淨買賣（負值＝賣超）。2026-07-17 為 -44,183,964。
investment_trust_net_buy_sell — 投信淨買賣（此處 +1,488,520,為買超）。
dealer_net_buy_sell — 自營商淨買賣（此處 +2,759,348）。
total_institutional_net_buy_sell — 三者合計（-39,936,096）。source_role 與 lineage 讓每列可回溯官方 TWSE T86 報表。

用途 — 外資連續買超天數

把 rows 依 date 排序,數 foreign_net_buy_sell > 0 的連續天數;中斷即歸零。

import requests rows = requests.get(    "https://api.twmarketdata.com/v2/datasets/institutional-flow",    params={"symbol": "2330", "start_date": "2026-06-01", "end_date": "2026-07-18"},    headers={"X-API-Key": "sk_live_..."},).json()["rows"] streak = 0for r in sorted(rows, key=lambda x: x["date"]):    streak = streak + 1 if r["foreign_net_buy_sell"] > 0 else 0print("current foreign buying streak:", streak, "days")

英文為語義改寫,非機器翻譯。

步驟 3 — 讀回應

真實 200 回應（顯示一列,2330 於 2026-07-17）。信封為 { dataset, count, rows }:

{  "dataset": "institutional_flow",  "count": 4,  "rows": [    {      "symbol": "2330",      "date": "2026-07-17",      "foreign_net_buy_sell": -44183964.0,      "investment_trust_net_buy_sell": 1488520.0,      "dealer_net_buy_sell": 2759348.0,      "total_institutional_net_buy_sell": -39936096.0,      "source_role": "official_twse_t86",      "lineage": { "endpoint_name": "T86", "source_authority": "TWSE T86", "payload_date": "20260717" }    }  ]}

你要看的欄位

foreign_net_buy_sell — 外資淨買賣（負值＝賣超）。2026-07-17 為 -44,183,964。

investment_trust_net_buy_sell — 投信淨買賣（此處 +1,488,520,為買超）。

dealer_net_buy_sell — 自營商淨買賣（此處 +2,759,348）。

total_institutional_net_buy_sell — 三者合計（-39,936,096）。source_role 與 lineage 讓每列可回溯官方 TWSE T86 報表。

用途 — 外資連續買超天數

把 rows 依 date 排序,數 foreign_net_buy_sell > 0 的連續天數;中斷即歸零。

import requests rows = requests.get(    "https://api.twmarketdata.com/v2/datasets/institutional-flow",    params={"symbol": "2330", "start_date": "2026-06-01", "end_date": "2026-07-18"},    headers={"X-API-Key": "sk_live_..."},).json()["rows"] streak = 0for r in sorted(rows, key=lambda x: x["date"]):    streak = streak + 1 if r["foreign_net_buy_sell"] > 0 else 0print("current foreign buying streak:", streak, "days")