Ownership distribution

Overview

ownership-distribution returns one row per stock per holding-size tier per data date from the official TDCC shareholding-distribution table, showing how many holders and shares sit in each tier. It is published on a weekly cadence; each row carries its source role so a tier figure is traceable to the TDCC release.

Coverage

Measured database state — present in the table, NOT yet served. These are not purchasable coverage figures: the endpoint is not open, so nothing below can be queried today.

Licence and attribution

Part of the data in this service is obtained from the Government Open Data Platform (data.gov.tw) and used under the Open Government Data License, version 1.0. Providing agencies: Taiwan Stock Exchange, Taipei Exchange, Taiwan Futures Exchange, Taiwan Depository & Clearing Corporation, National Development Council, Central Bank of the Republic of China (Taiwan), Department of Statistics of the Ministry of Economic Affairs, and Customs Administration of the Ministry of Finance. The value-added processing, derived calculations and presentation in this service are the responsibility of TWMD and are not associated with the providing agencies.

TW Market Data. (n.d.). Ownership distribution [Data set]. TW Market Data. Retrieved 2026-09-05, from https://twmarketdata.com/en/docs/api/capital-flows/ownership-distribution

The version is the dataset's own as_of, not the date this page was built. Where we have no as_of the field is left out rather than filled in. Check a signature

Getting started

1. Put your key in the X-API-Key header.
2. Add query parameters (symbol, date range, limit).
3. Send the request and read the returned payload.

curl "https://api.twmarketdata.com/v2/datasets/ownership-distribution?ticker=2330" \
  -H "X-API-Key: sk_live_..."

Filtering

Python

import requests

resp = requests.get(
    "https://api.twmarketdata.com/v2/datasets/ownership-distribution",
    params={"ticker": "2330"},
    headers={"X-API-Key": "sk_live_..."},
)
resp.raise_for_status()
print(resp.json())

OpenAPI

This endpoint is GET /v2/datasets/ownership-distribution. The full machine-readable schema (parameters, security, response envelope) lives in the OpenAPI spec.

Notes & limitations

• Weekly cadence: TDCC publishes the distribution on a settlement-dated weekly basis, so the latest data_date trails the current trading day.