籌碼與資金
法人買賣
提供三大法人的買賣超資料，適合用於資金動能分析與籌碼監控。
GET
/v2/datasets/institutional-flowOverview#
法人買賣 API 提供三大法人買賣超資料，適合用於資金動能分析與籌碼監控。
此頁為主公開 productized endpoint，回應固定為 dataset/rows/count + meta。
- 追蹤外資/投信/自營商資金流向。
- 建立法人動能與反轉訊號。
- 搭配價格與融資融券做交叉分析。
Request#
使用此 endpoint 時，symbol 為必要參數。
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": "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
}
}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，已作為法人買賣超的正式查詢入口。
- 若需融資融券補充資料，請搭配 `/v2/datasets/margin-short`。
- 若需更底層籌碼流向面，請參考 `/v2/datasets/chip-flows`。
Plan Requirement#
- Free（限制）
- Developer
- Pro
- Enterprise