AI agent？先讀 /llms.txt 取得全站索引。
籌碼與資金
TWSE 三大法人每日買賣超與淨流量，來源為官方 T86 報表。
GET /v2/datasets/institutional-flowinstitutional-flow 以 TWSE T86 為源，每交易日每檔股票回傳外資、投信、自營商買賣超一列；附來源角色，數字可回溯官方報表。
| 欄位 | 型別 | 說明 |
|---|---|---|
symbol | string | 股票代碼。 |
date | string | 交易日。 |
foreign_net | number | 外資買賣超（股）。 |
trust_net | number | 投信買賣超（股）。 |
dealer_net | number | 自營商買賣超（股）。 |
source_role | string | official_twse_t86。 |
| 列數 | 11,744,999 |
| 涵蓋起訖 | 2012-05-02 至 2026-07-17 |
| 分級 | 已驗證 |
此為本端點的真實回應。資料列位於 "rows" 之下，來源資訊如下方所示；各資料集形狀不盡相同，請以本頁為準。
{ "dataset": "institutional_flow", "rows": [ { "market": "TWSE", "foreign_buy": null, "foreign_sell": null, "investment_trust_buy": null, "investment_trust_sell": null, "dealer_buy": null, "dealer_sell": null, "foreign_holding_ratio": null, "institutional_participation_ratio": null, "provider": "twse_official", "source_role": "official_twse_t86", "lineage": { "row_index": 1317, "source_hash": "f14371bed1a88a8714924ba6122d36fd11429f8663e4d4c73501ed226878c382", "payload_date": "20260717", "request_date": "2026-07-17", "endpoint_name": "T86", "source_authority": "TWSE T86" }, "updated_at": "2026-07-17T17:34:55.593720", "universe_class": "common_stock", "is_common_universe": true, "symbol": "2330", "as_of_date": "2026-07-17", "date": "2026-07-17", "foreign_net_buy_sell": -44183964, "investment_trust_net_buy_sell": 1488520, "dealer_net_buy_sell": 2759348, "total_institutional_net_buy_sell": -39936096 }, { "market": "TWSE", "foreign_buy": null, "foreign_sell": null, "investment_trust_buy": null, "investment_trust_sell": null, "dealer_buy": null, "dealer_sell": null, "foreign_holding_ratio": null, "institutional_participation_ratio": null, "provider": "twse_official", "source_role": "official_twse_t86", "lineage": { "row_index": 1273, "source_hash": "edadfac40097e48752713d46f70e7596c77b694bdf412ab096f6373c140ac106", "payload_date": "20260716", "request_date": "2026-07-16", "endpoint_name": "T86", "source_authority": "TWSE T86" }, "updated_at": "2026-07-17T17:34:55.593720", "universe_class": "common_stock", "is_common_universe": true, "symbol": "2330", "as_of_date": "2026-07-16", "date": "2026-07-16", "foreign_net_buy_sell": -4214736, "investment_trust_net_buy_sell": 528374, "dealer_net_buy_sell": 1061380, "total_institutional_net_buy_sell": -2624982 } ], "count": 50}擷取自 2026-07-20 的線上 API。
curl "https://api.twmarketdata.com/v2/datasets/institutional-flow?symbol=2330&start_date=2026-06-01&end_date=2026-07-15&limit=5" \ -H "X-API-Key: sk_live_..."| 參數 | 必填 | 型別 | 說明 |
|---|---|---|---|
symbol | 是 | string | 股票代碼，例如 2330。 |
start_date | 否 | string (YYYY-MM-DD) | 查詢起始日期。 |
end_date | 否 | string (YYYY-MM-DD) | 查詢結束日期。 |
limit | 否 | integer | 回傳筆數上限。 |
第一個呼叫：
import requests resp = requests.get( "https://api.twmarketdata.com/v2/datasets/institutional-flow", params={"symbol": "2330", "limit": "5"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json()["rows"])帶日期區間篩選：
import requests # The full verified example — the same call with every supported filter set.resp = requests.get( "https://api.twmarketdata.com/v2/datasets/institutional-flow", params={"symbol": "2330", "start_date": "2026-06-01", "end_date": "2026-07-15", "limit": "5"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()for row in resp.json()["rows"]: print(row)此端點為 GET /v2/datasets/institutional-flow。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。