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,故此處不述。

欄位型別說明
tickerstring
marketstring
taxonomy_namestring
taxonomy_versionstring
class_codestring
as_of_datestring
confidencenull

範例回應

此為本端點的真實回應。資料列位於 "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

快速開始

  1. 把你的金鑰放進 X-API-Key 標頭。
  2. 加上查詢參數(symbol、日期區間、limit)。
  3. 送出請求並讀取 data 陣列。
curl "https://api.twmarketdata.com/v2/datasets/issuer-classification?symbol=2330" \  -H "X-API-Key: sk_live_..."

篩選參數

參數必填型別說明
symbolstring以股票代碼篩選單一標的。
limitinteger回傳筆數上限。

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。