AI agent？先讀 /llms.txt 取得全站索引。
籌碼與資金
集保持股分級集中度:每筆為某股之集保股權分散資料,含總股東數、≥400 張與 ≥1000 張大戶之戶數與持股占集保比、散戶比,及週對週變動。衍生自 TDCC 集保股權分散表 15 級距。非預測、非建議。
GET /v2/datasets/shareholding-concentration即將開放——此資料集建置中,尚未可透過 API 查詢。下方涵蓋與誠實限制為真實資料庫狀態;serving 上線(預計 8/1)後脫離「建置中」。
| 欄位 | 型別 | 說明 |
|---|---|---|
holder_count_total | holders | |
large_holder_count_400 | holders | ≥400 lots |
large_holder_pct_400 | ratio | |
large_holder_pct_1000 | ratio | ≥1000 lots (千張大戶) |
retail_pct | ratio | |
large_holder_pct_1000_wow_delta | ratio | NULL on single snapshot |
1,978 列,報表日 2026-05-29 —僅最新一週快照(視圖取 TDCC 最新週報)。單一快照下週變動欄(wow_delta)為 NULL。級距版本 tdcc_15tier_v1;底層表另有歷史週序列。
此為本端點的真實回應。資料列位於 "data" 之下，來源資訊如下方所示；各資料集形狀不盡相同，請以本頁為準。
{ "dataset_id": "shareholding-concentration", "row_count": 1, "data": [ { "ticker": "1101", "market": "TWSE", "report_date": "2026-05-29", "holder_count_total": 523992, "large_holder_count_400": 933, "large_holder_pct_400": 0.5477, "large_holder_pct_1000": 0.5056, "retail_pct": 0.0027 } ]}擷取自 2026-07-20 的線上 API。
curl "https://api.twmarketdata.com/v2/datasets/shareholding-concentration?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/shareholding-concentration", 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/shareholding-concentration", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()for row in resp.json()["data"]: print(row)此端點為 GET /v2/datasets/shareholding-concentration。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。