EN 登入註冊

AI agent？先讀 /llms.txt 取得全站索引。

籌碼與資金

三大法人買賣

Name: Institutional flow
Creator: TW Market Data
License: https://twmarketdata.com/zh-TW/legal/licensing

TWSE 三大法人每日買賣超與淨流量，來源為官方 T86 報表。

← 三大法人買賣資料集總覽

已驗證來源: TWSE·方案: starter·計費: 2 點·GET /v2/datasets/institutional-flow

三大法人買賣是台灣市場資料集,來源為 TWSE,由 TW Market Data 以 GET /v2/datasets/institutional-flow 提供。

總覽

institutional-flow 以 TWSE T86 為源，每交易日每檔股票回傳外資、投信、自營商買賣超一列；附來源角色，數字可回溯官方報表。

欄位	型別	說明
`market`	string
`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
`universe_class`	string
`is_common_universe`	boolean
`symbol`	string	股票代碼。
`as_of_date`	string
`date`	string	交易日。
`foreign_net_buy_sell`	number
`investment_trust_net_buy_sell`	number
`dealer_net_buy_sell`	number
`total_institutional_net_buy_sell`	number

涵蓋範圍

列數	約 11,801,071
涵蓋起訖	2012-05-02 – 2026-09-03
分級	已驗證
量測時間	2026-09-04取自資料集登錄表

範例回應

此為本端點的真實回應。資料列位於 "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": 1186,
        "source_hash": "aa6628fdc5b51ff9c21033e544be39305d19e99d402164cc4c58923c30d827f9",
        "payload_date": "20260804",
        "request_date": "2026-08-04",
        "endpoint_name": "T86",
        "source_authority": "TWSE T86"
      },
      "updated_at": "2026-08-04T09:31:15.296611",
      "universe_class": "common_stock",
      "is_common_universe": true,
      "symbol": "1301",
      "as_of_date": "2026-08-04",
      "date": "2026-08-04",
      "foreign_net_buy_sell": 762896,
      "investment_trust_net_buy_sell": -162000,
      "dealer_net_buy_sell": -1105183,
      "total_institutional_net_buy_sell": -504287
    },
    {
      "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": 1309,
        "source_hash": "c6f28a3d8883de3696bdf505090066d18770f8e09205713e4b2362216d093de3",
        "payload_date": "20260803",
        "request_date": "2026-08-03",
        "endpoint_name": "T86",
        "source_authority": "TWSE T86"
      },
      "updated_at": "2026-08-03T09:31:31.818825",
      "universe_class": "common_stock",
      "is_common_universe": true,
      "symbol": "1301",
      "as_of_date": "2026-08-03",
      "date": "2026-08-03",
      "foreign_net_buy_sell": -5079620,
      "investment_trust_net_buy_sell": 0,
      "dealer_net_buy_sell": -381973,
      "total_institutional_net_buy_sell": -5461593
    }
  ],
  "count": 50
}

擷取自 2026-07-20 的線上 API。

出處

以下欄位會隨資料一併回傳,記錄這一列的來源。它們屬於出處而非本資料集要講的事實,因此列在這裡而不進欄位表。

providersource_rolelineageupdated_at

授權與顯名

本服務部分資料取自政府資料開放平臺(data.gov.tw),依「政府資料開放授權條款-第1版」授權利用。資料提供機關:臺灣證券交易所、證券櫃檯買賣中心、臺灣期貨交易所、臺灣集中保管結算所、國家發展委員會、中央銀行、經濟部統計處、財政部關務署。本服務之加值處理、衍生計算與呈現方式由 TWMD 負責,與各資料提供機關無涉。

引用此資料集

TW Market Data. (n.d.). 三大法人買賣 [Data set]. TW Market Data. Retrieved 2026-09-05, from https://twmarketdata.com/zh-TW/docs/api/capital-flows/institutional-flow

版本取自資料集自己的 as_of，不是這一頁的產生日期。沒有 as_of 的資料集就不列這個欄位，不會補一個看起來合理的值。驗證簽章

可與本資料集對齊的其他資料集。每組都標出可用來 join 的欄位,規劃跨表查詢時不必自己猜。

融資融券
可用 as_of_date + market + ticker + trade_date 對齊
技術指標
可用 as_of_date + market + ticker + trade_date 對齊
外資持股比率
可用 market + ticker + trade_date 對齊
借券使用率
可用 market + ticker + trade_date 對齊
借券資料
可用 as_of_date + market + ticker 對齊

快速開始

把你的金鑰放進 X-API-Key 標頭。
加上查詢參數（symbol、日期區間、limit）。
送出請求並讀取 rows 陣列。

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	回傳筆數上限。

Python 範例

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"])

OpenAPI

此端點為 GET /v2/datasets/institutional-flow。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。

備註與限制

部分列在上游標記 is_placeholder:true——將數值視為定案前請先檢查此旗標。

請求與回應

請求

curl "https://api.twmarketdata.com/v2/datasets/institutional-flow?symbol=2330&start_date=2026-01-01&end_date=2026-06-30&limit=5" \
  -H "X-API-Key: $TWMD_API_KEY"

回應

{
  "dataset": "institutional_flow",
  "rows": [
    {
      "market": "<string>",
      "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": "<string>",
      "source_role": "<string>",
      "lineage": {
        "row_index": "<number>",
        "source_hash": "<string>",
        "payload_date": "<string>",
        "request_date": "<string>",
        "endpoint_name": "<string>",
        "source_authority": "<string>"
      },
      "updated_at": "<string>",
      "universe_class": "<string>",
      "is_common_universe": "<boolean>",
      "symbol": "<string>",
      "as_of_date": "<string>",
      "date": "<string>",
      "foreign_net_buy_sell": "<number>",
      "investment_trust_net_buy_sell": "<number>",
      "dealer_net_buy_sell": "<number>",
      "total_institutional_net_buy_sell": "<number>"
    }
  ],
  "count": 50
}