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

市場結構與參考

券商分點參考

Name: Broker-branch reference
Creator: TW Market Data
License: https://twmarketdata.com/zh-TW/legal/licensing

券商分點參考——將每個券商分點代碼對映到所屬券商與分點身分的查表。

← 券商分點參考資料集總覽

參考來源: TWSE·方案: free·計費: 1 點·GET /v2/datasets/broker-branch-reference

券商分點參考是台灣市場資料集,來源為 TWSE,由 TW Market Data 以 GET /v2/datasets/broker-branch-reference 提供。

總覽

broker-branch-reference 為參考型資料集:每個券商分點一筆現用紀錄,用於將分點進出資料中出現的分點代碼解析為可讀的券商與分點名稱。此為查表面,非成交時間序列。

欄位	型別	說明
`parent_broker_code`	string
`parent_broker_name`	string
`branch_code`	string	券商分點代碼。
`branch_name`	string	分點名稱。
`market`	string
`address`	string

涵蓋範圍

列數	約 814
涵蓋起訖	2026-08-23 – 2026-08-23
分級	參考
量測時間	2026-09-01取自資料集登錄表

範例回應

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

{
  "api_version": "v2",
  "dataset": "broker_branch_reference",
  "dataset_version": "v2.0.0-preview",
  "release_version": "v2.2026-08-06.preview",
  "release_date": "2026-08-06",
  "data_as_of": "2026-08-06",
  "request_context": {
    "ticker": "1020",
    "as_of_date": "2026-08-06",
    "family": "discovery_reference",
    "field_group_type": "canonical",
    "dataset_view": "broker_branch_reference_v1",
    "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": 53,
    "branch_count": 814,
    "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": {
        "emitter": "build_broker_branch_refresh_candidates",
        "open_date": "830923",
        "branch_code": "601T",
        "broker_code": "&#29319;亞",
        "source_date": "1150804",
        "source_role": "official_twse_broker_branch_reference",
        "source_family": "official_twse_broker_branch_reference",
        "raw_branch_name": "&#29319;亞-自營",
        "source_provider": "twse_official",
        "broker_id_source": "derived_from_branch_name",
        "source_canonical": "official_twse_broker_branch_reference",
        "branch_name_guess": "自營",
        "broker_name_guess": "&#29319;亞"
      },
      "data_gaps": [
        "broker_id_unresolved_fallback_key"
      ]
    },
    {
      "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": {
        "emitter": "build_broker_branch_refresh_candidates",
        "open_date": "1080102",
        "branch_code": "601d",
        "broker_code": "&#29319;亞",
        "source_date": "1150804",
        "source_role": "official_twse_broker_branch_reference",
        "source_family": "official_twse_broker_branch_reference",
        "raw_branch_name": "&#29319;亞-鑫豐",
        "source_provider": "twse_official",
        "broker_id_source": "derived_from_branch_name",
        "source_canonical": "official_twse_broker_branch_reference",
        "branch_name_guess": "鑫豐",
        "broker_name_guess": "&#29319;亞"
      },
      "data_gaps": [
        "broker_id_unresolved_fallback_key"
      ]
    }
  ],
  "quality": {
    "freshness_state": "fresh",
    "freshness_as_of": "2026-08-06",
    "completeness_ratio": 1,
    "quality_status": "ready"
  },
  "lineage": {
    "source_role": "canonical",
    "selected_source": "broker_branch_reference",
    "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-20260806",
    "blocking_gate": null
  },
  "dataset_id": "broker_branch_reference",
  "data_count": 50,
  "known_gaps": [
    "address_missing",
    "broker_id_unresolved_fallback_key",
    "not_investment_advice"
  ],
  "warnings": [
    "not_investment_advice",
    "reference_only",
    "not_trading_activity_coverage"
  ]
}

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

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

出處

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

source_providersource_rolesource_familysource_lineagedata_gaps

授權與顯名

本服務部分資料取自政府資料開放平臺(data.gov.tw),依「政府資料開放授權條款-第1版」授權利用。資料提供機關:臺灣證券交易所、證券櫃檯買賣中心、臺灣期貨交易所、臺灣集中保管結算所、國家發展委員會、中央銀行、經濟部統計處、財政部關務署。本服務之加值處理、衍生計算與呈現方式由 TWMD 負責,與各資料提供機關無涉。

引用此資料集

TW Market Data. (n.d.). 券商分點參考 [Data set]. TW Market Data. Retrieved 2026-09-05, from https://twmarketdata.com/zh-TW/docs/api/structure-reference/broker-branch-reference

版本取自資料集自己的 as_of，不是這一頁的產生日期。沒有 as_of 的資料集就不列這個欄位，不會補一個看起來合理的值。驗證簽章

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

證券商總表
可用 market 對齊
交易制度沿革表
可用 market 對齊
公司產業曝險
可用 market 對齊
同業對照組
可用 market 對齊
產業價值鏈成員
可用 market 對齊
權證參考
可用 market 對齊

快速開始

把你的金鑰放進 X-API-Key 標頭。
加上查詢參數（symbol、日期區間、limit）。
送出請求並讀取 data 陣列。

curl "https://api.twmarketdata.com/v2/datasets/broker-branch-reference?market=TWSE" \
  -H "X-API-Key: sk_live_..."

篩選參數

參數	必填	型別	說明
`parent_broker_code`	否	string	由端點自身在 envelope.request_context.supported_filter_fields 宣告。
`branch_code`	否	string	由端點自身在 envelope.request_context.supported_filter_fields 宣告。
`parent_broker_name`	否	string	由端點自身在 envelope.request_context.supported_filter_fields 宣告。

Python 範例

import requests

resp = requests.get(
    "https://api.twmarketdata.com/v2/datasets/broker-branch-reference",
    params={"market": "TWSE"},
    headers={"X-API-Key": "sk_live_..."},
)
resp.raise_for_status()
print(resp.json()["data"])

OpenAPI

此端點為 GET /v2/datasets/broker-branch-reference。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。

備註與限制

僅現用快照／查表——非倖存者偏誤安全的時間序列;過去已裁撤或更名的分點不會被重建。

請求與回應

請求

curl "https://api.twmarketdata.com/v2/datasets/broker-branch-reference" \
  -H "X-API-Key: $TWMD_API_KEY"

回應

{
  "api_version": "v2",
  "dataset": "broker_branch_reference",
  "dataset_version": "v2.0.0-preview",
  "release_version": "v2.2026-08-06.preview",
  "release_date": "2026-08-06",
  "data_as_of": "2026-08-06",
  "data": [
    {
      "parent_broker_code": "<string>",
      "parent_broker_name": "<string>",
      "branch_code": "<string>",
      "branch_name": "<string>",
      "market": "<string>",
      "address": "<string>",
      "source_provider": "<string>",
      "source_role": "<string>",
      "source_family": "<string>",
      "source_lineage": {
        "emitter": "<string>",
        "open_date": "<string>",
        "branch_code": "<string>",
        "broker_code": "<string>",
        "source_date": "<string>",
        "source_role": "<string>",
        "source_family": "<string>",
        "raw_branch_name": "<string>",
        "source_provider": "<string>",
        "broker_id_source": "<string>",
        "source_canonical": "<string>",
        "branch_name_guess": "<string>",
        "broker_name_guess": "<string>"
      },
      "data_gaps": "<array>"
    }
  ],
  "quality": {
    "freshness_state": "<string>",
    "freshness_as_of": "<string>",
    "completeness_ratio": "<number>",
    "quality_status": "<string>"
  },
  "error": {
    "error_code": "<null>",
    "error_message": "<null>",
    "dataset": "<string>",
    "request_id": "<string>",
    "blocking_gate": "<null>"
  },
  "dataset_id": "broker_branch_reference",
  "data_count": 50,
  "known_gaps": [
    "<string>"
  ],
  "warnings": [
    "<string>"
  ]
}