AI agent？先讀 /llms.txt 取得全站索引。
市場結構與參考
公司基本資料——每家上市櫃公司的企業基本檔（登記名稱、產業、上市櫃別、重要日期）。
GET /v2/datasets/issuer-profileissuer-profile 為參考型資料集:每家發行公司一筆現用紀錄,非時間序列。用於將代碼解析為公司登記身分、產業與上市櫃別。此為現用快照——更名、產業重分類與資本變動的完整 point-in-time 歷史尚未整合。
| 欄位 | 型別 | 說明 |
|---|---|---|
symbol | string | 股票代碼。 |
company_name | string | 公司登記名稱。 |
industry | string | 產業分類。 |
board | string | 上市櫃別（TWSE／TPEx）。 |
listing_date | string | 上市櫃日期。 |
source_role | string | official_twse_issuer_profile。 |
| 列數 | 1,084 |
| 涵蓋起訖 | 參考資料，無時間序列 |
| 分級 | 參考 |
此為本端點的真實回應。資料列位於 "envelope.data" 之下，來源資訊如下方所示；各資料集形狀不盡相同，請以本頁為準。
{ "api_version": "v2", "endpoint": "/v2/datasets/issuer-profile", "request_id": "req_b0ee95457597", "plan_id": "enterprise", "dataset": "issuer_profile", "query": { "symbol": "2330", "market": null, "limit": 50 }, "meta": { "rows_returned": 1, "mandatory_contract_fields_present": [ "api_version", "data", "data_as_of" ], "plan": "enterprise", "row_limit": 100000, "is_limited": false }, "envelope": { "api_version": "v2", "dataset": "issuer_profile", "dataset_version": "v2.0.0-preview", "release_version": "v2.2026-05-28.preview", "release_date": "2026-05-28", "data_as_of": "2026-05-28", "request_context": { "ticker": "2330", "as_of_date": "2026-05-28", "family": "discovery_reference", "field_group_type": "canonical", "dataset_view": "issuer_profile_v1" }, "data": [ { "symbol": "2330", "company_name": "台灣積體電路製造股份有限公司", "market": "TWSE", "industry": "24", "isin": null, "listing_date": "1994-09-05", "chairperson": null, "general_manager": null, "capital": null, "address": null, "website": "https://www.tsmc.com", "source_name": "official_twse_openapi_t187ap03_l", "source_url": null, "announcement_type": null, "source_as_of": "2026-05-28", "updated_at": "2026-07-17T15:58:24.532904" } ], "quality": { "freshness_state": "fresh", "freshness_as_of": "2026-05-28", "completeness_ratio": 1, "quality_status": "ready" }, "lineage": { "source_role": "canonical", "selected_source": "issuer_profiles", "fallback_chain": [], "policy_notes": [ "official/public-first canonical", "issuer profile mapped from canonical issuer_profiles table", "nullable profile fields are preserved as-is" ] }, "error": { "error_code": null, "error_message": null, "dataset": "issuer_profile", "request_id": "read-api-590902c52ef5", "blocking_gate": null } }}擷取自 2026-07-20 的線上 API。
本頁顯示原始中文值；英文頁會以標記取代，以維持全英文。
curl "https://api.twmarketdata.com/v2/datasets/issuer-profile?symbol=2330" \ -H "X-API-Key: sk_live_..."| 參數 | 必填 | 型別 | 說明 |
|---|---|---|---|
symbol | 否 | string | 以股票代碼篩選單一標的。 |
limit | 否 | integer | 回傳筆數上限。 |
第一個呼叫：
import requests resp = requests.get( "https://api.twmarketdata.com/v2/datasets/issuer-profile", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json()["envelope"]["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-profile", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()for row in resp.json()["envelope"]["data"]: print(row)此端點為 GET /v2/datasets/issuer-profile。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。