AI agent?先讀 /llms.txt 取得全站索引。
市場結構與參考
發行人分類
發行人分類
參考來源: TWSE / TPEx·方案: free·計費: 1 點·
GET /v2/datasets/issuer-classification發行人分類是台灣市場資料集,來源為 TWSE / TPEx,由 TW Market Data 以 GET /v2/datasets/issuer-classification 提供。
總覽
發行人分類——後端 meta 未提供 grain,故此處不述。
| 欄位 | 型別 | 說明 |
|---|---|---|
ticker | string | |
market | string | |
taxonomy_name | string | |
taxonomy_version | string | |
class_code | string | |
as_of_date | string | |
confidence | null |
範例回應
此為本端點的真實回應。資料列位於 "data" 之下,來源資訊如下方所示;各資料集形狀不盡相同,請以本頁為準。
{ "dataset_id": "issuer_classification", "request_context": { "scope": "tw_issuer_taxonomy_classification", "coverage_type": "current_state_reference", "filters": { "ticker": "1101", "market": null, "industry": null, "limit": 50 } }, "quality": { "row_count": 4, "ticker_count": 1, "rows_exceed_tickers": true, "sensitive_fields_exposed": false }, "lineage": { "sources": [], "versions": [ "v1" ], "semantics": "Taxonomy class codes assigned to each issuer, with the taxonomy name and version that produced them. A CURRENT-STATE map: every row carries the same as_of_date, so it stamps the snapshot rather than forming a series." }, "error": null, "data": [ { "ticker": "1101", "market": "TWSE", "taxonomy_name": "industry", "taxonomy_version": "v1", "class_code": "01", "as_of_date": "2026-08-03", "confidence": null, "provider": "tw_feature_engine", "source_role": "derived_theme_taxonomy" }, { "ticker": "1101", "market": "TWSE", "taxonomy_name": "industry", "taxonomy_version": "v1", "class_code": "01", "as_of_date": "2026-05-30", "confidence": null, "provider": "tw_feature_engine", "source_role": "derived_theme_taxonomy" } ], "data_count": 4, "known_gaps": [ "one_issuer_can_carry_several_taxonomies_so_ticker_is_not_unique_in_this_surface", "as_of_date_is_the_snapshot_stamp_not_a_series_every_row_shares_it", "current_state_snapshot_not_a_time_series_there_is_no_history_to_range_over" ], "warnings": [ "not_investment_advice" ], "envelope": { "dataset_id": "issuer_classification", "scope": "tw_issuer_taxonomy_classification", "row_count": 4 }}擷取自 2026-07-20 的線上 API。
出處
以下欄位會隨資料一併回傳,記錄這一列的來源。它們屬於出處而非本資料集要講的事實,因此列在這裡而不進欄位表。
providersource_role快速開始
- 把你的金鑰放進 X-API-Key 標頭。
- 加上查詢參數(symbol、日期區間、limit)。
- 送出請求並讀取 data 陣列。
curl "https://api.twmarketdata.com/v2/datasets/issuer-classification?symbol=2330" \ -H "X-API-Key: sk_live_..."篩選參數
| 參數 | 必填 | 型別 | 說明 |
|---|---|---|---|
symbol | 否 | string | 以股票代碼篩選單一標的。 |
limit | 否 | integer | 回傳筆數上限。 |
Python 範例
第一個呼叫:
import requests resp = requests.get( "https://api.twmarketdata.com/v2/datasets/issuer-classification", 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/issuer-classification", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()for row in resp.json()["data"]: print(row)OpenAPI
此端點為 GET /v2/datasets/issuer-classification。完整機器可讀 schema(參數、認證、回應封裝)見 OpenAPI spec。
備註與限制
- 後端 meta 未提供 grain 與欄位清單,故不列欄位表;knowledge_time_field 為 as_of_date,後端標記為 point-in-time safe。