TW Market Data LogoTW Market Data

統計與事實

事實總覽

台股的長期統計基準,每一個數字都附樣本區間與 as_of

季節性

逐月報酬分布與勝率,含樣本數

法人動向

三大法人買賣超廣度的季節性分布

漲跌停事件

漲跌停的發生頻率與集中度

下市與存續

下市家數與存續期間,回測避開倖存者偏誤的基礎

規則沿革

交易制度變更的時間軸,解讀歷史資料時的前提

資料與探索

資料集總覽

全部資料集、涵蓋範圍與更新頻率

Playground

不用金鑰,直接在瀏覽器裡打一次 API

市場快照

當日市場概況與重點數字

個股分析

單一標的的資料檢視入口

熱力圖

全市場一張圖:面積是市值,顏色是營收年增率

台股日程

法定揭露截止日:一筆資料哪一天依法才能被知道

產品能力

產品概覽

TWMD 提供什麼,以及它為誰而做

可驗證證明

簽章 checkpoint 與逐列 inclusion proof

資料品質

對帳、缺漏處理與品質狀態

方法學

數字怎麼算出來的,以及口徑

可稽核交割

把交易決策連回它當時看到的資料

券商串接

把 TWMD 接進既有下單與研究流程

開發者

文件

API 參考、資料集頁與整合指南

快速開始

認證與你的第一個 request

依角色整合

量化研究、資料工程與應用開發各自的路徑

MCP 連線

讓 agent 直接連上 TWMD

MCP registry

已發布的 MCP tool 清單與簽章 manifest

Webhooks

資料更新時主動通知你的系統

學習

部落格

資料、方法與市場結構的長文

問答

具體問題的具體答案,附資料出處

主題

產業鏈與主題的關聯檢視

說明中心

帳號、計費與使用上的常見問題

名詞表

台股與資料領域的名詞定義

比較與狀態

為何選 TWMD

與 FinMind、TEJ 的逐項比較

從 FinMind 搬遷

欄位對映與搬遷步驟

從 FinLab 搬遷

欄位對映與搬遷步驟

從 TEJ 搬遷

欄位對映與搬遷步驟

系統狀態

服務可用性與事件紀錄

安全與信任

信任中心

我們宣稱什麼、以及每個宣稱的界線

安全中心

架構、存取控制與事件處理

安全事實

可以從外部自行查證的項目

安全證據

SBOM、ASVS 對照與威脅模型,含未達成的三條。

自我評估

採購問卷用的逐項回覆

合規與標準

合規對應

證據原語對應到 FSB、IOSCO 與 SR 26-2

資料標準

逐條對應到已發布標準,以及對不上的地方

資料溯源與 C2PA

機器可讀的來源圖,免金鑰取得

授權條款

資料的使用與再散布範圍

導入

方案評估

不用帳號就能自己跑的七項檢查

聯絡銷售

企業方案、額度與合約細節

方案價格
EN登入註冊
TW Market Data

台股資料基礎設施 · 為 AI agent 與量化流程而建。

狀態未知
© 2026 TW Market Data

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

  • 隱私權政策·
  • 服務條款·
  • Cookie 政策·
  • 可接受使用政策·
  • 資料來源與授權·
  • 法律文件總覽
EN

AI Agent

  • MCP Server
  • Skills 技能包
  • 工具清單
  • Agent 工作流範例
  • Agent 評測題庫
  • llms.txt
  • OpenAPI 規格

Security

  • 資安總覽
  • 可驗證資料
  • 信任中心
  • 標準與相容性
  • 監理對照表

Product

  • 資料集總覽
  • 題材研究
  • 統計資料
  • 文件
  • 接入指南
  • 試玩台(免註冊)
  • 免費方案
  • 解決方案

Company

  • 關於 TWMD
  • 部落格
  • 幫助中心
  • 方案價格

文件總覽

DASHBOARD

儀表板定價

FOR AI AGENTS

MCP ServerSkills(技能包)llms.txt工具清單OpenAPI SpecAgent 工作流範例

OVERVIEW

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

DATA APIS

GUIDES

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

SDKS

Release StatusPython SDKJavaScript / TypeScript SDK

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

財務與分析

財報(損益表)

提供公司損益表關鍵欄位,適合用於基本面分析、估值研究與策略建模。

GET/v2/datasets/income-statement

Overview

此資料集為「財報資料」的一部分,建議搭配現金流量表一起使用(`/docs/api/financial-growth/cash-flow-statement`)。

損益表 API 提供公司期間性的營收與獲利欄位,適合用於基本面分析與研究流程。

資料來自公開揭露來源,並以結構化欄位回傳;本次為文件同步更新,不涉及 API 行為變更。

  • 追蹤公司季度與年度獲利表現。
  • 搭配估值資料做相對評價分析。
  • 建立財務因子與成長性模型。
  • 與月營收資料交叉驗證營運趨勢。

覆蓋範圍

標的數起始年更新時點含已下市
尚未提供(coming)尚未提供(coming)尚未提供(coming)coming

數字為 DB 實測;未列者以 docs coverage 為準(coming),不逐格編造。

Request

使用此 endpoint 時,建議:

Query Parameters

欄位型別Required說明
symbolstringyes股票代碼(內部對應 ticker)。
start_datestringno查詢起始日期(YYYY-MM-DD)。
end_datestringno查詢結束日期(YYYY-MM-DD)。
limitintegerno回傳筆數限制。

Response Shape

回應結構固定為 dataset、rows、count。

{
"dataset": "income_statement",
"rows": [
{
"symbol": "2330",
"fiscal_year": 2025,
"fiscal_quarter": 4,
"period_type": "quarterly",
"period_end_date": "2025-12-31",
"report_date": "2026-03-08",
"source": "mops_official",
"revenue": 625000000000,
"gross_profit": 320000000000,
"operating_income": 250000000000,
"pretax_income": 246000000000,
"net_income": 210000000000,
"eps": 8.1
}
],
"count": 1
}

Field 說明

欄位路徑型別說明
rows[].symbolstring股票代碼。
rows[].fiscal_yearinteger財政年度。
rows[].fiscal_quarterinteger|null財政季度。
rows[].period_typestring期間類型(quarterly/annual/ttm)。
rows[].period_end_datestring財報期間結束日期。
rows[].report_datestring|null公告或報告日期。
rows[].revenuenumber|null營收。
rows[].gross_profitnumber|null毛利。
rows[].operating_incomenumber|null營業利益。
rows[].pretax_incomenumber|null稅前淨利。
rows[].net_incomenumber|null稅後淨利。
rows[].epsnumber|null每股盈餘。
countinteger回傳資料筆數。

Usage Notes / 使用建議

  • Baseline freeze signoff 已通過(income_statement):驗證視窗為 2023-06-30..2026-03-31。
  • 來源與主表:mops_official,source-of-truth table 為 `fundamental_income_statements`。
  • 覆蓋統計:duplicate logical keys=0;實際覆蓋筆數與涵蓋股票數詳見 /datasets。
  • 資料治理:raw_payload 非空筆數=0(不保留 raw payload)。
  • 冪等性證據:would_insert=0、would_update=0(high confidence)。
  • 財報資料互補:建議搭配現金流量表 `/v2/datasets/cash-flow-statement` 一起分析公司獲利與現金品質。
  • 欄位完整度會因公司與期間不同而有差異,缺值應以 null 處理。
  • 日期欄位以 Asia/Taipei 財報語意(YYYY-MM-DD)為準。
  • 若需三大表完整欄位,請搭配財報三表相關資料主題。
  • Canonical 補充:`/v2/datasets/financials` 為較低層查詢面,支援 statement_type/period_type。
  • 一般產品整合建議優先使用本頁主公開 endpoint `/v2/datasets/income-statement`。
  • 限制聲明:本頁不宣稱即時資料(real-time)、不構成投資建議,且不額外主張 TPEx/OTC 完整覆蓋。
  • 範圍聲明:本頁僅陳述已驗證期間與統計,不主張超出 2023-06-30..2026-03-31 的完整歷史覆蓋。

限制與注意

  • 覆蓋非全市場、全期間;實際範圍以上方覆蓋小表與回應中的 data_gaps 為準。
  • 資料有缺會如實標記,不以推測值補洞。
  • 本平台聚焦日頻與基本面資料;不提供即時報價、盤中分K與加密貨幣。
  • TWSE 為 verified baseline;TPEx 歷史深度與還原股價目前為 beta / deferred,逐集標示。
  • 查詢不支援 as_of 參數(列於路線圖);point-in-time 請以各列的 knowledge_date 自行過濾,該日期保守設為法定申報截止日。日線價格不帶此欄位。

Plan Requirement

  • Free(限制)
  • Developer
  • Pro
  • Enterprise

此 API 屬於 TW Market Data 資料集目錄。 查看資料集總覽

請求與回應

請求範例

curl --request GET \  --url "https://api.twmarketdata.com/v2/datasets/income-statement?symbol=2330&start_date=2025-01-01&end_date=2026-12-31&limit=12" \  --header "X-API-Key: your_api_key_here"

狀態碼

成功回傳損益表資料

JSON
{  "dataset": "income_statement",  "rows": [    {      "symbol": "2330",      "fiscal_year": 2025,      "fiscal_quarter": 4,      "period_type": "quarterly",      "period_end_date": "2025-12-31",      "report_date": "2026-03-08",      "source": "mops_official",      "revenue": 625000000000,      "gross_profit": 320000000000,      "operating_income": 250000000000,      "pretax_income": 246000000000,      "net_income": 210000000000,      "eps": 8.1    }  ],  "count": 1}