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

股票分割/面額事件增強公司行動ESG(TESG)公司行動下市生命週期處置證券期間公司風險事件事件日曆

GUIDES

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

SDKS

Release StatusPython SDKJavaScript / TypeScript SDK

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

公司與事件

增強公司行動

增強公司行動,已預先計算價格調整因子——與公司行動相同的資料流,另附原本需自行推導的累積與單筆事件調整因子。

衍生來源: TWSE / TPEx / MOPS·方案: pro·計費: 2 點·GET /v2/datasets/corporate-actions-enhanced

總覽

corporate-actions-enhanced 為推導型資料集:以官方公司行動揭露為基礎,附上用於建構還原價格序列的單筆與累積調整因子。lineage 欄位回指底層官方行動,基準事件可稽核而非黑箱。

欄位型別說明
symbolstring股票代碼。
action_typestring正規化行動類型(如 cash_dividend、split)。
titlestring揭露之行動標題。
ex_datestring除權(息)日。
adjustment_factornumber單筆事件價格調整因子(推導)。
cumulative_factornumber截至當日之累積調整因子(推導)。
source_rolestring正規來源角色(derived_corporate_action_enhanced)。

涵蓋範圍

列數275
涵蓋起訖2001-01-20 至 2026-07-20
分級衍生

範例回應

TODO —— 尚未擷取到此資料集的真實回應(需要有權限的 API 金鑰,或其必填參數尚未確認)。寧可留白,也不顯示未經實測的範例。

快速開始

  1. 把你的金鑰放進 X-API-Key 標頭。
  2. 加上查詢參數(symbol、日期區間、limit)。
  3. 送出請求並讀取回傳內容。
curl "https://api.twmarketdata.com/v2/datasets/corporate-actions-enhanced?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/corporate-actions-enhanced",    params={"symbol": "2330"},    headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json())

帶日期區間篩選:

import requests # The full verified example — the same call with every supported filter set.resp = requests.get(    "https://api.twmarketdata.com/v2/datasets/corporate-actions-enhanced",    params={"symbol": "2330"},    headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json())

OpenAPI

此端點為 GET /v2/datasets/corporate-actions-enhanced。完整機器可讀 schema(參數、認證、回應封裝)見 OpenAPI spec。

備註與限制

  • 推導而非官方揭露:調整因子由官方公司行動計算,會承接上游更正——回測時請以 as_of 行動重新計算。

請求與回應

請求

curl "https://api.twmarketdata.com/v2/datasets/corporate-actions-enhanced?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_ 金鑰。

回應

TODO —— 尚未擷取到此資料集的真實回應(需要有權限的金鑰,或其必填參數尚未確認)。寧可不顯示範例,也不編造。

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