Skip to main content

Ownership TDCC Distribution

取得指定個股在日期區間內、每期集保戶股權分散資料，含各持股級距的股東人數、持股股數與佔集保庫存比例。

GET /ownership/tdcc-distribution/{symbol}
info

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

Parameters​

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

Response​

NameTypeDescription
type*string證券類型
exchange*string交易所
market*string市場別
symbol*string個股代號
data*object[]每期一筆
data.date*string公布基準日
data.distributions*object[]各持股級距明細
data.distributions.range*string持股級距（股），15 個固定級距；另含「合計」列，部分期別含「異動」（差異數調整）列
data.distributions.holders*number股東人數
data.distributions.shares*number持股股數（股）
data.distributions.proportion*number佔集保庫存比例（百分比值，84.67 即 84.67%）
資料說明
  • 資料來源：整理自臺灣集中保管結算所公開之集保戶股權分散表。
  • 資料頻率：每週公布一次，date 為公布基準日（多為週五，遇假日可能提前）；2015-05-08 以前之歷史資料為每月一筆。
  • 歷史涵蓋：自 2013-07-01 起；涵蓋上市、上櫃、興櫃個股。
  • 單日查詢：資料僅落在公布基準日；僅提供 from 或 to 其一（視同單日查詢）且該日非公布基準日時，回傳 data: []。
  • 查詢區間：單次查詢 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/tdcc-distribution/2330?from=2026-08-07&to=2026-08-07' \
  -H 'X-API-KEY: <YOUR_API_KEY>'

Response Body：

{
  "type": "EQUITY",
  "exchange": "TWSE",
  "market": "TSE",
  "symbol": "2330",
  "data": [
    {
      "date": "2026-08-07",
      "distributions": [
        {
          "range": "1-999",
          "holders": 2523071,
          "shares": 293744991,
          "proportion": 1.13
        },
        {
          "range": "1000-5000",
          "holders": 454920,
          "shares": 869533934,
          "proportion": 3.35
        },
        {
          "range": "5001-10000",
          "holders": 53011,
          "shares": 379122752,
          "proportion": 1.46
        },
        {
          "range": "10001-15000",
          "holders": 17491,
          "shares": 214496406,
          "proportion": 0.82
        },
        {
          "range": "15001-20000",
          "holders": 8096,
          "shares": 142302572,
          "proportion": 0.54
        },
        {
          "range": "20001-30000",
          "holders": 7803,
          "shares": 190826713,
          "proportion": 0.73
        },
        {
          "range": "30001-40000",
          "holders": 3686,
          "shares": 127930452,
          "proportion": 0.49
        },
        {
          "range": "40001-50000",
          "holders": 2048,
          "shares": 92338466,
          "proportion": 0.35
        },
        {
          "range": "50001-100000",
          "holders": 4123,
          "shares": 288118496,
          "proportion": 1.11
        },
        {
          "range": "100001-200000",
          "holders": 2053,
          "shares": 288258115,
          "proportion": 1.11
        },
        {
          "range": "200001-400000",
          "holders": 1314,
          "shares": 368794003,
          "proportion": 1.42
        },
        {
          "range": "400001-600000",
          "holders": 584,
          "shares": 285446281,
          "proportion": 1.1
        },
        {
          "range": "600001-800000",
          "holders": 353,
          "shares": 246354564,
          "proportion": 0.94
        },
        {
          "range": "800001-1000000",
          "holders": 208,
          "shares": 186782272,
          "proportion": 0.72
        },
        {
          "range": "1000001以上",
          "holders": 1475,
          "shares": 21958321050,
          "proportion": 84.67
        },
        {
          "range": "異動",
          "holders": 1,
          "shares": 1000,
          "proportion": 0
        },
        {
          "range": "合計",
          "holders": 3080236,
          "shares": 25932370067,
          "proportion": 100
        }
      ]
    }
  ]
}
Last updated on