TW Market Data LogoTW Market Data

核心資料

市場與價格

TWSE / TPEx 日線、還原價格、指數與市場廣度

財務與成長

月營收、財報三表、財務指標與估值資料

籌碼與資金

三大法人與融資融券資料

公司與結構

公司與事件

公司基本資料、公告、事件、公司行動與股利

分類與結構

主題分類、指數分類與跨資料集 mapping

策略與量化

Features、Factor Data、Time Alignment 與 Screener

平台能力

API 存取

REST API、認證與第一個 request

查詢與工具

Search API、Query API、欄位清單與查詢範例

Tools / MCP

Agent workflow、MCP tools 與 OpenAPI 入口

方案價格文件觀點文章
EN儀表板

TW Market Data(TWMD)提供之歷史資料與統計,非投資建議;投資決策與風險由您自行判斷。

隱私政策|服務條款|幫助中心||EN|TW Market Data © 2026

文件總覽

DASHBOARD

儀表板定價

FOR AI AGENTS

MCP Serverllms.txt工具清單OpenAPI SpecAgent 工作流範例
Webhooks建置中

OVERVIEW

總覽快速開始認證來源政策資料分級資料血緣市場覆蓋

DATA APIS

選股器公司基本資料股票主檔主題分類權證參考券商分點參考產業價值鏈成員因子庫(座標)因子報酬(十分位價差)交易制度沿革表

GUIDES

如何取得財報三表如何查三大法人籌碼如何看市場狀態如何接策略・AI Agent

SDKS

Release StatusPython SDKJavaScript / TypeScript SDK

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

市場結構與參考

交易制度沿革表

交易制度沿革表:台股微結構制度變更之參考時間軸(每日漲跌幅放寬、現股當沖開放、tick 升降單位…),每筆含 rule_domain/rule_key/生效日、前後值、市場、說明與官方 source_url。非預測、非建議。

建置中來源: TWSE·方案: free·計費: 1 點·GET /v2/datasets/trading-rules-reference

總覽

即將開放——此資料集建置中,尚未可透過 API 查詢。下方涵蓋與誠實限制為真實資料庫狀態;serving 上線(預計 8/1)後脫離「建置中」。

欄位型別說明
rule_domainenumprice_limit / day_trading / tick_size …
rule_keytext
effective_datedate
prior_valuetext
new_valuetext
marketenumTWSE,TPEX
source_urlurlrequired (無出處不入表)
source_authoritytext

涵蓋範圍

檔案式參考(F+5 YAML,非資料表):src/feature_engine/data_gateway/reference/trading_rules_reference.yaml,rule_version=v1。紅線:無出處不入表——每筆均附 source_url;source_verification=pending_owner 者於 owner 確認前標示。

範例回應

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

{  "dataset_id": "trading-rules-reference",  "row_count": 1,  "data": [    {      "rule_key": "twse_tpex_daily_price_limit",      "effective_date": "2015-06-01",      "prior_value": "7%",      "new_value": "10%",      "market": "TWSE,TPEX",      "source_url": "https://www.twse.com.tw/zh/products/rule/limit.html",      "source_authority": "TWSE",      "rule_domain": "price_limit"    }  ]}

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

快速開始

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

篩選參數

參數必填型別說明
symbol是string股票代碼,例如 2330。
start_date否string (YYYY-MM-DD)查詢起始日期。
end_date否string (YYYY-MM-DD)查詢結束日期。
limit否integer回傳筆數上限。

Python 範例

第一個呼叫:

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

備註與限制

  • 建置中/即將開放:尚未經 API 服務。上方數字為量測的資料庫狀態(WAVE_L_REGISTRY),serving 上線前誠實呈現,非即時端點。

請求與回應

請求

curl "https://api.twmarketdata.com/v2/datasets/trading-rules-reference?symbol=2330&start_date=2026-01-01&end_date=2026-06-30&limit=5" \  -H "X-API-Key: $TWMD_API_KEY"

以 X-API-Key 標頭認證,使用儀表板發放的 sk_live_ 金鑰。

回應

JSON
{  "dataset_id": "trading-rules-reference",  "row_count": 1,  "data": [    {      "rule_key": "twse_tpex_daily_price_limit",      "effective_date": "2015-06-01",      "prior_value": "7%",      "new_value": "10%",      "market": "TWSE,TPEX",      "source_url": "https://www.twse.com.tw/zh/products/rule/limit.html",      "source_authority": "TWSE",      "rule_domain": "price_limit"    }  ]}

擷取自對此端點的真實呼叫,非手寫。

此資料集的資料列在 "data" 之下。各資料集的信封不同,請以本頁為準,勿沿用其他頁的形狀。

本頁的分級徽章屬文件分級,並非回應欄位。