Taiwan Shareholding Dispersion (TDCC 集保戶股權分散表)

Get structured JSON access to the weekly shareholding dispersion table from TDCC (Taiwan Depository & Clearing Corporation) — the definitive dataset for Taiwan chip analysis (籌碼分析): who owns each stock, from odd-lot retail to 1,000+ lot whales.

Every week TDCC publishes, for every Taiwan security, the number of shareholders and shares held across 15 holding-size tiers. This Actor normalizes that into one JSON record per stock per week, with the famous >400-lot big-holder ratio (大戶持股比) pre-computed.

Why this data matters

• 大戶持股比 (>400-lot holder %) is one of the most-watched ownership signals in Taiwan — rising whale concentration with falling retail count is a classic accumulation pattern
• Retail holder count (level 1: 1-999 shares) tracks odd-lot retail crowding, a contrarian indicator
• Weekly frequency sits perfectly between daily institutional flows and quarterly filings
• Used by virtually every Taiwan chip-analysis platform — now you can pipe the raw official data into your own models

Output

One record per security per weekly snapshot. Key fields:

{
  "date": "2026-07-24",
  "stock_code": "2330",
  "total_holders": 3041119,
  "total_shares": 25932370067,
  "large_holders": 2618,
  "large_shares": 22690712233,
  "large_pct": 87.48,
  "level_01_holders": 2486327,
  "level_01_shares": 288004489,
  "level_01_pct": 1.11,
  "level_15_holders": 1472,
  "level_15_shares": 21966501280,
  "level_15_pct": 84.7,
  "diff_adjustment_shares": 0
}

Each of the 15 tiers has _holders, _shares, _pct fields (45 tier fields total). Tier definitions (shares held):

Level	Range	Level	Range
1	1-999	9	50,001-100,000
2	1,000-5,000	10	100,001-200,000
3	5,001-10,000	11	200,001-400,000
4	10,001-15,000	12	400,001-600,000
5	15,001-20,000	13	600,001-800,000
6	20,001-30,000	14	800,001-1,000,000
7	30,001-40,000	15	1,000,001+
8	40,001-50,000

large_* = sum of levels 12-15 (>400,000 shares = >400 lots, the standard 大戶 threshold). diff_adjustment_shares is TDCC's reconciliation row, normalized so that total_shares = Σ level shares + diff_adjustment_shares.

Input

Field	Type	Description
stockCodes	array	Optional filter, e.g. ["2330", "2317"]. Empty = all ~4,000 securities (latest week only)
weeks	integer	Weekly snapshots to fetch, 1-52 (default 1). weeks > 1 requires stockCodes

Full-market snapshot (latest week, ~4,000 securities):

{ "stockCodes": [], "weeks": 1 }

One year of history for a watchlist:

{ "stockCodes": ["2330", "2454", "5274"], "weeks": 52 }

Historical mode is capped at stocks × weeks ≤ 600 per run to keep polite request pacing; split larger backfills across runs.

Pricing & cost control

Pay per result: $0.50 / 1,000 records (one record = one stock-week).

• Full market, latest week: ~4,000 records ≈ $2.00
• 10 tickers × 52 weeks: 520 records ≈ $0.26

Data source & reliability

• Direct from TDCC's official open-data feed (full-market snapshot) and TDCC's official per-stock query service (history, ~12 months available)
• Both endpoints cross-validated against each other — identical numbers for the same stock/week
• Share-count reconciliation identity is verified for every record at parse time; schema drift fails loudly instead of returning silently corrupted data
• New snapshots publish weekly (data date = last business day of the week)

Use cases

• 大戶/散戶 ownership trend screeners and alerts
• Whale accumulation detection combined with institutional flows
• Retail crowding contrarian indicators
• Ownership-concentration factor research and backtesting
• Financial dashboards, newsletters, and stock-picking tools

Related Actors

• TWSE Institutional Trades — daily foreign/trust/dealer flows, main board
• TPEx Institutional Trades — same for the OTC market
• Taiwan Margin Trading Balance — daily margin & short selling balances
• Taiwan Monthly Revenue — monthly revenue of all listed companies