Building an AI agent? Start with /llms.txt for the full site index.
Market Structure & Reference
Broker-branch reference — the lookup table mapping each broker branch code to its brokerage and branch identity.
GET /v2/datasets/broker-branch-referencebroker-branch-reference is a reference dataset: one active record per broker branch, used to resolve a branch code appearing in broker-trading data into a readable brokerage and branch name. It is a lookup surface, not a time series of trades.
| Field | Type | Description |
|---|---|---|
branch_code | string | Broker branch code. |
broker_code | string | Parent brokerage code. |
broker_name | string | Parent brokerage name. |
branch_name | string | Branch name. |
source_role | string | official_twse_broker_branch. |
| Rows | 811 |
| Window | Reference data, no time series |
| Grade | Reference |
A real response from this endpoint. Rows are returned under "data", and provenance is carried in the shape shown below — it is not identical across datasets, so read this page's rather than assuming another's.
{ "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": "<Chinese value - see the zh page>", "parent_broker_name": "<Chinese value - see the zh page>", "branch_code": "601T", "branch_name": "<Chinese value - see the zh page>", "market": "TWSE", "address": "<Chinese value - see the zh page>", "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": "<Chinese value - see the zh page>", "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": "<Chinese value - see the zh page>", "source_provider": "twse_official", "broker_id_source": "derived_from_branch_name", "source_canonical": "official_twse_broker_branch_reference", "branch_name_guess": "<Chinese value - see the zh page>", "broker_name_guess": "<Chinese value - see the zh page>" }, "data_gaps": [] }, { "parent_broker_code": "<Chinese value - see the zh page>", "parent_broker_name": "<Chinese value - see the zh page>", "branch_code": "601d", "branch_name": "<Chinese value - see the zh page>", "market": "TWSE", "address": "<Chinese value - see the zh page>", "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": "<Chinese value - see the zh page>", "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": "<Chinese value - see the zh page>", "source_provider": "twse_official", "broker_id_source": "derived_from_branch_name", "source_canonical": "official_twse_broker_branch_reference", "branch_name_guess": "<Chinese value - see the zh page>", "broker_name_guess": "<Chinese value - see the zh page>" }, "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" ]}Captured from the live API on 2026-07-20.
Chinese data values are shown as a marker here so this page stays in English; the /zh page shows them verbatim.
curl "https://api.twmarketdata.com/v2/datasets/broker-branch-reference?symbol=2330" \ -H "X-API-Key: sk_live_..."| Parameter | Required | Type | Description |
|---|---|---|---|
symbol | No | string | Ticker to filter to a single security. |
limit | No | integer | Maximum rows to return. |
A first call:
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"])With a date-range filter:
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)This endpoint is GET /v2/datasets/broker-branch-reference. The full machine-readable schema (parameters, security, response envelope) lives in the OpenAPI spec.