AI agent？先讀 /llms.txt 取得全站索引。
籌碼與資金
每家公司每個申報月份的董監事持股，來源為公開資訊觀測站（MOPS）——持有股數與設質股數。
GET /v2/datasets/insider-director-holdingsinsider-director-holdings 以官方 MOPS 董監持股揭露為源，每家公司每個申報月份回傳一列，含董監事持股合計與設質股數；每列附來源角色與回溯 MOPS 申報的 lineage，持股可追溯而非黑箱。
| 欄位 | 型別 | 說明 |
|---|---|---|
symbol | string | 股票代碼。 |
period | string | 申報月份（YYYY-MM）。 |
director_shares | number | 董監事持股合計（股）。 |
pledged_shares | number | 董監事設質股數。 |
holding_ratio | number | 董監持股占已發行股數比率（0-1）。 |
source_role | string | 正規來源角色（official_mops_insider_holding）。 |
TODO — 精確列數／標的數與涵蓋視窗待量測快照；來源為官方 MOPS 董監持股揭露（涵蓋至最新揭露月份）。寧不顯示計數也不捏造。
此為本端點的真實回應。資料列位於 "data" 之下，來源資訊如下方所示；各資料集形狀不盡相同，請以本頁為準。
{ "dataset_id": "insider_director_holdings", "request_context": { "scope": "insider_director_holdings_latest_balance_snapshot_only", "coverage_type": "latest_balance_snapshot_only", "filters": { "ticker": null, "market": null, "source_as_of_date": null, "holder_name": null, "holder_role": null, "holder_category": null, "source_family": null, "limit": 50 }, "min_source_as_of_date": "2026-05-20", "max_source_as_of_date": "2026-05-20" }, "quality": { "row_count": 50, "ticker_count": 3, "sensitive_fields_exposed": false }, "lineage": { "source_providers": [ "tpex_official" ], "source_roles": [ "insider_director_holdings_snapshot" ], "source_families": [ "tpex_insider_balance_snapshot" ] }, "error": null, "data": [ { "ticker": "1240", "market": "TPEx", "source_as_of_date": "2026-05-20", "holder_name": "鍾亮宏", "holder_role": "副總經理本人", "holder_category": "manager", "holding_shares": 111169, "holding_ratio": null, "pledge_shares": 0, "source_provider": "tpex_official", "source_role": "insider_director_holdings_snapshot", "source_family": "tpex_insider_balance_snapshot", "source_row_key": "TPEx|2026-05-20|1240|副總經理本人|鍾亮宏", "lineage": { "source_family": "tpex_insider_balance_snapshot", "source_dataset": "t187ap11_balance_snapshot", "source_provider": "tpex_official" }, "data_gaps": [ "holding_ratio_not_source_provided" ], "not_investment_advice": true }, { "ticker": "1240", "market": "TPEx", "source_as_of_date": "2026-05-20", "holder_name": "黃大中", "holder_role": "副總經理本人", "holder_category": "manager", "holding_shares": 612766, "holding_ratio": null, "pledge_shares": 0, "source_provider": "tpex_official", "source_role": "insider_director_holdings_snapshot", "source_family": "tpex_insider_balance_snapshot", "source_row_key": "TPEx|2026-05-20|1240|副總經理本人|黃大中", "lineage": { "source_family": "tpex_insider_balance_snapshot", "source_dataset": "t187ap11_balance_snapshot", "source_provider": "tpex_official" }, "data_gaps": [ "holding_ratio_not_source_provided" ], "not_investment_advice": true } ], "data_count": 50, "known_gaps": [ "latest_balance_snapshot_only", "holding_ratio_nullable_by_policy", "not_transaction_reconstruction" ], "warnings": [ "not_investment_advice" ], "not_investment_advice": true, "envelope": { "dataset_id": "insider_director_holdings", "scope": "insider_director_holdings_latest_balance_snapshot_only", "row_count": 50 }}擷取自 2026-07-20 的線上 API。
本頁顯示原始中文值；英文頁會以標記取代，以維持全英文。
curl "https://api.twmarketdata.com/v2/datasets/insider-director-holdings?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/insider-director-holdings", 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/insider-director-holdings", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()for row in resp.json()["data"]: print(row)此端點為 GET /v2/datasets/insider-director-holdings。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。