Building an AI agent? Start with /llms.txt for the full site index.
籌碼與資金
提供三大法人的買賣超資料，適合用於資金動能分析與籌碼監控。
/v2/datasets/institutional-flow法人買賣 API 提供三大法人買賣超資料，適合用於資金動能分析與籌碼監控。
此頁為主公開 productized endpoint，回應固定為 dataset/rows/count + meta。
| 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.
使用此 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": "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
}
}| 欄位路徑 | 型別 | 說明 |
|---|---|---|
| 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 資料集目錄。 查看資料集總覽