Cookies 使用設定
我們使用必要 cookies 維持登入與安全，並使用分析 cookies 改善產品體驗。不會用於廣告追蹤。了解更多
籌碼與資金
提供三大法人的買賣超資料，適合用於資金動能分析與籌碼監控。
/v2/datasets/institutional-flow法人買賣 API 提供三大法人買賣超資料，適合用於資金動能分析與籌碼監控。
此頁為主公開 productized endpoint，回應固定為 dataset/rows/count + meta。
使用此 endpoint 時，symbol 為必要參數。
| 欄位 | 型別 | Required | 說明 |
|---|---|---|---|
| symbol | string | yes | 股票代碼（內部對應 ticker）。 |
| start_date | string | no | 查詢起始日期（YYYY-MM-DD）。 |
| end_date | string | no | 查詢結束日期（YYYY-MM-DD）。 |
| limit | integer | no | 回傳筆數（預設 100，最大 5000）。 |
回應結構固定為 dataset、rows、count，並附 meta（plan/row_limit/is_limited）。
{ "dataset": "institutional_flow", "rows": [ { "symbol": "2330", "date": "2026-04-22", "market": "TW", "foreign_net_buy_sell": 1523000, "investment_trust_net_buy_sell": -320000, "dealer_net_buy_sell": 180000, "total_institutional_net_buy_sell": 1383000, "foreign_buy": 8123000, "foreign_sell": 6600000, "investment_trust_buy": 980000, "investment_trust_sell": 1300000, "dealer_buy": 650000, "dealer_sell": 470000, "foreign_holding_ratio": 0.741, "institutional_participation_ratio": 0.684, "provider": "twse_official", "source_role": "canonical", "lineage": { "source_table": "institutional_flow_items" }, "updated_at": "2026-04-23T03:10:00+00:00" } ], "count": 1, "meta": { "plan": "free", "row_limit": 50, "is_limited": false }}| 欄位路徑 | 型別 | 說明 |
|---|---|---|
| rows[].symbol | string | 股票代碼。 |
| rows[].date | string | 交易日期（YYYY-MM-DD）。 |
| rows[].market | string | 市場代碼。 |
| rows[].foreign_net_buy_sell | number|null | 外資買賣超。 |
| rows[].investment_trust_net_buy_sell | number|null | 投信買賣超。 |
| rows[].dealer_net_buy_sell | number|null | 自營商買賣超。 |
| rows[].total_institutional_net_buy_sell | number|null | 三大法人合計買賣超。 |
| rows[].foreign_buy | number|null | 外資買進。 |
| rows[].foreign_sell | number|null | 外資賣出。 |
| rows[].investment_trust_buy | number|null | 投信買進。 |
| rows[].investment_trust_sell | number|null | 投信賣出。 |
| rows[].dealer_buy | number|null | 自營商買進。 |
| rows[].dealer_sell | number|null | 自營商賣出。 |
| rows[].foreign_holding_ratio | number|null | 外資持股比率。 |
| rows[].institutional_participation_ratio | number|null | 法人參與比率。 |
| rows[].provider | string | 來源供應者。 |
| rows[].source_role | string | 來源角色。 |
| rows[].lineage | object|string|null | 來源追溯資訊。 |
| rows[].updated_at | string|null | 資料更新時間。 |
| count | integer | 回傳資料筆數。 |
| meta.plan | string | 目前方案代碼。 |
| meta.row_limit | integer | 方案每次請求可回傳上限。 |
| meta.is_limited | boolean | 是否因方案限制而截斷資料。 |
此 API 屬於 TW Market Data 資料集目錄。 查看資料集總覽