Skip to main content

Ownership Director Holdings

取得指定個股在年月區間內、每月董事、監察人及經理人之持股餘額、設質股數與設質比率明細。

GET /ownership/director-holdings/{symbol}
info

屬於 開發者 及 進階用戶 方案的專屬功能！

Parameters​

NameTypeDescription
symbol*string個股代號（如 2330）
fromstring開始年月（格式：yyyy-MM，亦接受 yyyy-MM-dd、僅取年月）；與 to 皆省略時回最新月
tostring結束年月（格式：yyyy-MM，亦接受 yyyy-MM-dd、僅取年月）；僅提供 from 或 to 其一時，視同查詢該年月
sortstring依年月排序，預設 desc 降冪；可選 asc 升冪

Response​

NameTypeDescription
type*string證券類型
exchange*string交易所
market*string市場別
symbol*string個股代號
data*object[]每月一筆
data.date*string資料年月（格式：yyyy-MM）
data.directors*object[]董事、監察人及經理人持股明細
data.directors.order*number揭露順序（自 0 起）
data.directors.title*string職稱（如 董事長本人、獨立董事本人、總經理本人）
data.directors.name*string姓名或法人名稱
data.directors.electedSharesnumber選任時持股數（股）
data.directors.heldSharesnumber目前持股數（股）
data.directors.pledgedSharesnumber設質股數（股）
data.directors.pledgeRationumber設質比率（比例值，0.2146 即 21.46%）
data.directors.relatedHeldSharesnumber配偶、未成年子女及利用他人名義合計持有股數（股）
data.directors.relatedPledgedSharesnumber前述持股之設質股數（股）
data.directors.relatedPledgeRationumber前述持股之設質比率（比例值）
資料說明
  • 資料來源：整理自公開資訊觀測站之董事、監察人及經理人持股餘額明細資料。
  • 資料頻率：每月一筆，date 為資料年月。
  • 歷史涵蓋：自 2017-01 起提供連續月資料；另有 2010-01 單一期別，2010-02 至 2016-12 無資料。涵蓋上市、上櫃、興櫃個股；ETF 等無董監資料之代號回傳 data: []。
  • 年月語意：from／to 以月為單位；帶日的格式僅取年月（2026-07-15 視同 2026-07）。
  • 查詢區間：單次查詢 from 與 to 的間隔須小於 1 年，超過會回傳 400；日期不合法或 from 晚於 to 亦回傳 400。
  • 查無資料：代號不存在或該區間無資料時，皆回傳 200 與 data: []（不回 404）；此時 type／exchange／market 為預設值，不代表該代號的真實屬性。
  • 呼叫額度：台股盤後籌碼系列 API 共用同一呼叫額度（以方案的「台股盤後籌碼」額度計）。

Example​

curl -X 'GET' \
  'https://api.fugle.tw/marketdata/v1.0/stock/ownership/director-holdings/2330?from=2026-07&to=2026-08' \
  -H 'X-API-KEY: <YOUR_API_KEY>'

Response Body：

{
  "type": "EQUITY",
  "exchange": "TWSE",
  "market": "TSE",
  "symbol": "2330",
  "data": [
    {
      "date": "2026-07",
      "directors": [
        // 為節省篇幅僅列前 2 筆，實際回傳為當月全部明細；查詢當下 2026-08 尚未公布，故僅回傳 2026-07
        {
          "order": 0,
          "title": "董事長本人",
          "name": "魏哲家",
          "electedShares": 6392834,
          "heldShares": 7452349,
          "pledgedShares": 1600000,
          "pledgeRatio": 0.2146,
          "relatedHeldShares": 700261,
          "relatedPledgedShares": 0,
          "relatedPledgeRatio": 0
        },
        {
          "order": 1,
          "title": "董事本人",
          "name": "行政院國家發展基金管理會",
          "electedShares": 1653709980,
          "heldShares": 1653709980,
          "pledgedShares": 0,
          "pledgeRatio": 0,
          "relatedHeldShares": 0,
          "relatedPledgedShares": 0,
          "relatedPledgeRatio": 0
        }
      ]
    }
  ]
}
Last updated on