TW Market Data LogoTW Market Data

AI agent？先讀 /llms.txt 取得全站索引。

市場結構與參考

證券商總表

證券商總表

參考來源: TWSE·方案: free·計費: 1 點·GET /v2/datasets/securities-firm-master

證券商總表是台灣市場資料集,來源為 TWSE,由 TW Market Data 以 GET /v2/datasets/securities-firm-master 提供。

總覽

證券商總表——每列粒度:broker_id。

欄位型別說明
broker_idstring券商代號
broker_namestring券商名稱
tax_idstring
region_codestring
phonestring
faxstring
settlement_bankstring
business_statusnull營業狀態
business_typestring
chairmanstring
general_managerstring
admin_addressstring
notestring
registered_capital_knumber登記資本額(千元)
paid_capital_knumber
operating_capital_knumber
report_datestring
change_datestring
margin_start_datestring
established_datestring
business_start_datestring
marketstring
business_itemsarray營業項目

範例回應

此為本端點的真實回應。資料列位於 "data" 之下，來源資訊如下方所示；各資料集形狀不盡相同，請以本頁為準。

{  "dataset_id": "securities_firm_master",  "request_context": {    "scope": "twse_securities_firm_master_only",    "coverage_type": "current_snapshot_reference_master",    "filters": {      "broker_id": "1020",      "limit": 50    }  },  "quality": {    "row_count": 1,    "firm_count": 1,    "sensitive_fields_exposed": false  },  "lineage": {    "source_families": [      "TWSE_T187AP18"    ],    "semantics": "TWSE t187ap18 證券商基本資料 (firm-level master, not branch); 營業項目 collapsed to business_items array"  },  "error": null,  "data": [    {      "broker_id": "1020",      "broker_name": "合庫",      "tax_id": "53021481",      "region_code": "2　台北市",      "phone": "02-27528000",      "fax": "02-27526060",      "settlement_bank": "合作金庫商業銀行東台北分行",      "business_status": null,      "business_type": "經紀、自營、承銷",      "chairman": "吳瑞元",      "general_manager": "吳春敏",      "admin_address": "台北市松山區長安東路二段225號5樓、6樓；台北市中山區南京東路二段85、87號7樓(部分)",      "note": "該公司於100年12月2日分割設立完成",      "registered_capital_k": 3000000,      "paid_capital_k": 5206132,      "operating_capital_k": 0,      "report_date": "2026-08-05",      "change_date": "2026-05-29",      "margin_start_date": "2011-12-02",      "established_date": "2011-12-02",      "business_start_date": "2011-12-02",      "market": "TWSE",      "source_family": "TWSE_T187AP18",      "business_items": [],      "lineage": {        "grain": "firm_master",        "source": "TWSE_openapi_t187ap18",        "emitter": "build_securities_firm_master_candidates"      }    }  ],  "data_count": 1,  "known_gaps": [    "firm_level_master_not_branch_level",    "current_snapshot_reference_master",    "not_investment_advice"  ],  "warnings": [    "not_investment_advice"  ],  "envelope": {    "dataset_id": "securities_firm_master",    "scope": "twse_securities_firm_master_only",    "row_count": 1  }}

擷取自 2026-07-20 的線上 API。

本頁顯示原始中文值；英文頁會以標記取代，以維持全英文。

出處

以下欄位會隨資料一併回傳,記錄這一列的來源。它們屬於出處而非本資料集要講的事實,因此列在這裡而不進欄位表。

source_familylineage

相關資料集

可與本資料集對齊的其他資料集。每組都標出可用來 join 的欄位,規劃跨表查詢時不必自己猜。

快速開始

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

篩選參數

參數必填型別說明
symbol否string以股票代碼篩選單一標的。
limit否integer回傳筆數上限。

Python 範例

第一個呼叫：

import requests resp = requests.get(    "https://api.twmarketdata.com/v2/datasets/securities-firm-master",    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/securities-firm-master",    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/securities-firm-master。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。