AI agent？先讀 /llms.txt 取得全站索引。
市場結構與參考
券商分點參考——將每個券商分點代碼對映到所屬券商與分點身分的查表。
GET /v2/datasets/broker-branch-referencebroker-branch-reference 為參考型資料集:每個券商分點一筆現用紀錄,用於將分點進出資料中出現的分點代碼解析為可讀的券商與分點名稱。此為查表面,非成交時間序列。
| 欄位 | 型別 | 說明 |
|---|---|---|
branch_code | string | 券商分點代碼。 |
broker_code | string | 所屬券商代碼。 |
broker_name | string | 所屬券商名稱。 |
branch_name | string | 分點名稱。 |
source_role | string | official_twse_broker_branch。 |
| 列數 | 811 |
| 涵蓋起訖 | 參考資料，無時間序列 |
| 分級 | 參考 |
此為本端點的真實回應。資料列位於 "data" 之下，來源資訊如下方所示；各資料集形狀不盡相同，請以本頁為準。
{ "api_version": "v2", "dataset": "broker_branch_reference", "dataset_version": "v2.0.0-preview", "release_version": "v2.2026-07-20.preview", "release_date": "2026-07-20", "data_as_of": "2026-07-20", "request_context": { "ticker": "1020", "as_of_date": "2026-07-20", "family": "discovery_reference", "field_group_type": "canonical", "dataset_view": "broker_branch_reference_v1", "source_table": "broker_branch_reference_items", "scope": "broker_branch_reference_only", "coverage_type": "current_reference_snapshot", "supported_sort_by": [ "parent_broker_code", "branch_code" ], "supported_filter_fields": [ "parent_broker_code", "branch_code", "parent_broker_name" ], "parent_broker_count": 52, "branch_count": 811, "market_filter": "TWSE", "source_provider_filter": null, "source_role_filter": null, "source_family_filter": null }, "data": [ { "parent_broker_code": "犇亞", "parent_broker_name": "犇亞", "branch_code": "601T", "branch_name": "自營", "market": "TWSE", "address": "台北市松山區復興北路99號3樓", "source_provider": "twse_official", "source_role": "official_twse_broker_branch_reference", "source_family": "official_twse_broker_branch_reference", "source_lineage": { "open_date": "830923", "branch_code": "601T", "broker_code": "犇亞", "source_date": "1150608", "source_role": "official_twse_broker_branch_reference", "source_family": "official_twse_broker_branch_reference", "source_tables": { "broker_list": "brokerService/brokerList", "sec_reg_data": "brokerService/secRegData", "branch_reference": "opendata/OpenData_BRK02" }, "raw_branch_name": "犇亞-自營", "source_provider": "twse_official", "broker_id_source": "derived_from_branch_name", "source_canonical": "official_twse_broker_branch_reference", "branch_name_guess": "自營", "broker_name_guess": "犇亞" }, "data_gaps": [] }, { "parent_broker_code": "犇亞", "parent_broker_name": "犇亞", "branch_code": "601d", "branch_name": "鑫豐", "market": "TWSE", "address": "台北市松山區復興北路99號4樓之5", "source_provider": "twse_official", "source_role": "official_twse_broker_branch_reference", "source_family": "official_twse_broker_branch_reference", "source_lineage": { "open_date": "1080102", "branch_code": "601d", "broker_code": "犇亞", "source_date": "1150608", "source_role": "official_twse_broker_branch_reference", "source_family": "official_twse_broker_branch_reference", "source_tables": { "broker_list": "brokerService/brokerList", "sec_reg_data": "brokerService/secRegData", "branch_reference": "opendata/OpenData_BRK02" }, "raw_branch_name": "犇亞-鑫豐", "source_provider": "twse_official", "broker_id_source": "derived_from_branch_name", "source_canonical": "official_twse_broker_branch_reference", "branch_name_guess": "鑫豐", "broker_name_guess": "犇亞" }, "data_gaps": [] } ], "quality": { "freshness_state": "fresh", "freshness_as_of": "2026-07-20", "completeness_ratio": 1, "quality_status": "ready" }, "lineage": { "source_role": "canonical", "selected_source": "broker_branch_reference_items", "fallback_chain": [ "brokerService/brokerList", "brokerService/secRegData", "opendata/OpenData_BRK02" ], "policy_notes": [ "reference_only", "not_investment_advice", "not_trading_activity_coverage" ] }, "error": { "error_code": null, "error_message": null, "dataset": "broker_branch_reference", "request_id": "read-api-20260720", "blocking_gate": null }, "dataset_id": "broker_branch_reference", "data_count": 50, "known_gaps": [ "address_missing", "not_investment_advice", "not_trading_activity_coverage" ], "warnings": [ "not_investment_advice", "reference_only", "not_trading_activity_coverage" ]}擷取自 2026-07-20 的線上 API。
本頁顯示原始中文值；英文頁會以標記取代，以維持全英文。
curl "https://api.twmarketdata.com/v2/datasets/broker-branch-reference?symbol=2330" \ -H "X-API-Key: sk_live_..."| 參數 | 必填 | 型別 | 說明 |
|---|---|---|---|
symbol | 否 | string | 以股票代碼篩選單一標的。 |
limit | 否 | integer | 回傳筆數上限。 |
第一個呼叫：
import requests resp = requests.get( "https://api.twmarketdata.com/v2/datasets/broker-branch-reference", 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/broker-branch-reference", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()for row in resp.json()["data"]: print(row)此端點為 GET /v2/datasets/broker-branch-reference。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。