Building an AI agent? Start with /llms.txt for the full site index.

籌碼與資金

法人買賣

提供三大法人的買賣超資料，適合用於資金動能分析與籌碼監控。

This documentation page is currently available in Chinese only; English versions are coming soon.

GET/v2/datasets/institutional-flow

Overview

法人買賣 API 提供三大法人買賣超資料，適合用於資金動能分析與籌碼監控。

此頁為主公開 productized endpoint，回應固定為 dataset/rows/count + meta。

追蹤外資/投信/自營商資金流向。
建立法人動能與反轉訊號。
搭配價格與融資融券做交叉分析。

Coverage

Instruments	Start year	Update timing	Includes delisted
Not yet available (coming)	Not yet available (coming)	Not yet available (coming)	coming

Figures are measured from the DB; unlisted fields defer to docs coverage (coming) — we don't fabricate cell by cell.

Query Parameters

欄位	型別	Required	說明
symbol	string	yes	股票代碼（內部對應 ticker）。
start_date	string	no	查詢起始日期（YYYY-MM-DD）。
end_date	string	no	查詢結束日期（YYYY-MM-DD）。
limit	integer	no	回傳筆數（預設 100，最大 5000）。

Response Shape

回應結構固定為 dataset、rows、count，並附 meta（plan/row_limit/is_limited）。

{  "dataset": "institutional_flow",  "rows": [    {      "symbol": "2330",      "date": "2026-04-22",      "market": "TWSE",      "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_t86",      "source_role": "official_twse_t86",      "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  }}

Field 說明

欄位路徑	型別	說明
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	是否因方案限制而截斷資料。

Usage Notes / 使用建議

本頁為主公開 route，已作為法人買賣超的正式查詢入口。
目前公開契約僅驗證 TWSE-only；不宣稱 TPEx coverage 或 full-market coverage。
若回應中看到 legacy market='TW'，那是歷史正規化值，不應解讀為 TPEx coverage。
若需融資融券補充資料，請搭配 `/v2/datasets/margin-short`。

Limitations & notes

Coverage is not the full market or full history; the actual range is defined by the coverage table above and the data_gaps in the response.
Missing data is flagged honestly — we don't fill gaps with estimated values.
The platform focuses on daily-frequency and fundamental data; it does not provide real-time quotes, intraday bars, or cryptocurrencies.
TWSE is the verified baseline; TPEx history depth and adjusted prices are currently beta / deferred, flagged per dataset.

Plan Requirement

Free：不可用
Developer：文件可見，非正式商售宣告
Pro：可用（TWSE-only）
Enterprise：可用（TWSE-only）

此 API 屬於 TW Market Data 資料集目錄。查看資料集總覽

請求與回應

Request example

curl --request GET \  --url "https://api.twmarketdata.com/v2/datasets/institutional-flow?symbol=2330&start_date=2026-04-01&end_date=2026-04-22&limit=50" \  --header "X-API-Key: your_api_key_here"

Status codes

成功回傳法人買賣資料

JSON

{  "dataset": "institutional_flow",  "rows": [    {      "symbol": "2330",      "date": "2026-04-22",      "market": "TWSE",      "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_t86",      "source_role": "official_twse_t86",      "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  }}

Overview

法人買賣 API 提供三大法人買賣超資料，適合用於資金動能分析與籌碼監控。

此頁為主公開 productized endpoint，回應固定為 dataset/rows/count + meta。

追蹤外資/投信/自營商資金流向。

建立法人動能與反轉訊號。

搭配價格與融資融券做交叉分析。

Instruments

Start year

Update timing

Includes delisted

Not yet available (coming)

coming

欄位

型別

Required

說明

symbol

string

yes

股票代碼（內部對應 ticker）。

start_date

string

查詢起始日期（YYYY-MM-DD）。

end_date

string

查詢結束日期（YYYY-MM-DD）。

limit

integer

回傳筆數（預設 100，最大 5000）。

Response Shape

回應結構固定為 dataset、rows、count，並附 meta（plan/row_limit/is_limited）。

{  "dataset": "institutional_flow",  "rows": [    {      "symbol": "2330",      "date": "2026-04-22",      "market": "TWSE",      "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_t86",      "source_role": "official_twse_t86",      "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  }}

Field 說明

欄位路徑	型別	說明
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	是否因方案限制而截斷資料。

Usage Notes / 使用建議

本頁為主公開 route，已作為法人買賣超的正式查詢入口。

目前公開契約僅驗證 TWSE-only；不宣稱 TPEx coverage 或 full-market coverage。

若回應中看到 legacy market='TW'，那是歷史正規化值，不應解讀為 TPEx coverage。

若需融資融券補充資料，請搭配 `/v2/datasets/margin-short`。

Limitations & notes

Coverage is not the full market or full history; the actual range is defined by the coverage table above and the data_gaps in the response.

Missing data is flagged honestly — we don't fill gaps with estimated values.

The platform focuses on daily-frequency and fundamental data; it does not provide real-time quotes, intraday bars, or cryptocurrencies.

TWSE is the verified baseline; TPEx history depth and adjusted prices are currently beta / deferred, flagged per dataset.

{ "dataset": "institutional_flow", "rows": [ { "symbol": "2330", "date": "2026-04-22", "market": "TWSE", "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_t86", "source_role": "official_twse_t86", "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 }}