AI agent?先讀 /llms.txt 取得全站索引。
指南
查一檔股票每日的外資/投信/自營淨買賣超,再算連續買超天數。
抓一檔股票每日的三大法人籌碼——外資、投信、自營各淨買或淨賣多少。來源為官方 TWSE T86 報表,屬 Starter 方案。
在儀表板核發 API 金鑰,每次請求都在 X-API-Key 標頭帶上。
以 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"真實 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" }
}
]
}把 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 = 0
for r in sorted(rows, key=lambda x: x["date"]):
streak = streak + 1 if r["foreign_net_buy_sell"] > 0 else 0
print("current foreign buying streak:", streak, "days")