AI agent？先讀 /llms.txt 取得全站索引。
衍生與可轉債
TAIFEX 三大法人籌碼——上市期貨與選擇權中三大法人的每日淨部位。
GET /v2/datasets/taifex-institutional-flowtaifex-institutional-flow 以官方 TAIFEX 三大法人交易報表為源,每交易日每個契約回傳一列,含外資、投信與自營商淨部位;每列附來源角色,數字可回溯交易所報表,而非僅憑信任。
| 欄位 | 型別 | 說明 |
|---|---|---|
contract | string | 期貨／選擇權契約代碼(如 TXF、TXO)。 |
date | string | 交易日。 |
foreign_net | number | 外資淨部位(口)。 |
trust_net | number | 投信淨部位(口)。 |
dealer_net | number | 自營商淨部位(口)。 |
source_role | string | official_taifex。 |
| 列數 | 303 |
| 涵蓋起訖 | 2024-01-03 至 2026-06-05 |
| 分級 | 已驗證 |
此為本端點的真實回應。資料列位於 "data" 之下，來源資訊如下方所示；各資料集形狀不盡相同，請以本頁為準。
{ "dataset_id": "taifex_institutional_flow", "request_context": { "scope": "taifex_futures_options_institutional_flow_only", "coverage_type": "bounded_verified_snapshot_set", "filters": { "trade_date": null, "date_from": null, "date_to": null, "product_type": null, "contract_code": null, "investor_type": null, "source_family": null, "limit": 50 }, "min_trade_date": "2026-06-05", "max_trade_date": "2026-06-05" }, "quality": { "row_count": 50, "contract_count": 18, "sensitive_fields_exposed": false }, "lineage": { "source_providers": [ "taifex_official" ], "source_roles": [ "official_taifex_institutional_daily" ], "source_families": [ "official_taifex_derivatives_public_page" ] }, "error": null, "data": [ { "trade_date": "2026-06-05", "product_type": "futures", "market_type": "futures", "product_contract": "ETF期貨", "expiry_month": "ALL", "investor_type": "外資", "long_open_interest": 17842, "short_open_interest": 4475, "net_open_interest": 13367, "long_volume": 8418, "short_volume": 8978, "net_volume": -560, "source_provider": "taifex_official", "source_role": "official_taifex_institutional_daily", "source_family": "official_taifex_derivatives_public_page", "lineage": { "dataset": "futures_institutional_investors_daily", "trade_date": "2026-06-05", "official_first": true, "aggregate_scope": "all_expiries" }, "data_gaps": [ "{'reasons': ['optional_missing_currency', 'optional_missing_market_scope', 'optional_missing_settlement_type', 'optional_missing_unit', 'upstream_expiry_month_unavailable_aggregate_scope']}" ] }, { "trade_date": "2026-06-05", "product_type": "futures", "market_type": "futures", "product_contract": "ETF期貨", "expiry_month": "ALL", "investor_type": "投信", "long_open_interest": 4306, "short_open_interest": 50, "net_open_interest": 4256, "long_volume": 0, "short_volume": 0, "net_volume": 0, "source_provider": "taifex_official", "source_role": "official_taifex_institutional_daily", "source_family": "official_taifex_derivatives_public_page", "lineage": { "dataset": "futures_institutional_investors_daily", "trade_date": "2026-06-05", "official_first": true, "aggregate_scope": "all_expiries" }, "data_gaps": [ "{'reasons': ['optional_missing_currency', 'optional_missing_market_scope', 'optional_missing_settlement_type', 'optional_missing_unit', 'upstream_expiry_month_unavailable_aggregate_scope']}" ] } ], "data_count": 50, "known_gaps": [ "futures_options_institutional_flow_only", "no_settlement_price", "not_options_daily_price_table" ], "warnings": [ "not_investment_advice" ], "envelope": { "dataset_id": "taifex_institutional_flow", "scope": "taifex_futures_options_institutional_flow_only", "row_count": 50 }}擷取自 2026-07-20 的線上 API。
本頁顯示原始中文值；英文頁會以標記取代，以維持全英文。
curl "https://api.twmarketdata.com/v2/datasets/taifex-institutional-flow?symbol=2330" \ -H "X-API-Key: sk_live_..."| 參數 | 必填 | 型別 | 說明 |
|---|---|---|---|
symbol | 是 | string | 股票代碼，例如 2330。 |
start_date | 否 | string (YYYY-MM-DD) | 查詢起始日期。 |
end_date | 否 | string (YYYY-MM-DD) | 查詢結束日期。 |
limit | 否 | integer | 回傳筆數上限。 |
第一個呼叫：
import requests resp = requests.get( "https://api.twmarketdata.com/v2/datasets/taifex-institutional-flow", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json()["data"])帶日期區間篩選：
import requests # The full verified example — the same call with every supported filter set.resp = requests.get( "https://api.twmarketdata.com/v2/datasets/taifex-institutional-flow", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()for row in resp.json()["data"]: print(row)此端點為 GET /v2/datasets/taifex-institutional-flow。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。