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 取得全站索引。

籌碼與資金

融資融券

提供 TWSE-only private beta 融資融券資料,適合用於籌碼風險監控與市場擁擠度觀察。

GET/v2/datasets/margin-short

Overview

融資融券 API 目前以 TWSE-only private beta 方式提供,聚焦 official-first 的信用交易欄位。

文件必須保留 source_lineage、data_gaps 與 not_investment_advice,且不得把此資料說成 TPEx/full-market 或已啟用 daily write cron。

  • 監控融資融券餘額變化。
  • 建立信用交易風險濾網。
  • 與法人買賣資料做交叉分析。

覆蓋範圍

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

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

Request

使用此 endpoint 時,symbol 為必要參數,並建議明確指定 market=TWSE。

Query Parameters

欄位型別Required說明
symbolstringyes股票代碼;beta 相容請求參數。
marketstringno建議指定 TWSE;本頁不宣稱 TPEx 支援。
start_datestringno查詢起始日期(YYYY-MM-DD)。
end_datestringno查詢結束日期(YYYY-MM-DD)。
limitintegerno回傳筆數。

Response Shape

回應固定為 dataset、rows、count,加上 meta;欄位需保留 source_lineage、data_gaps 與 not_investment_advice。

{
"dataset": "margin_short",
"rows": [
{
"ticker": "0050",
"market": "TWSE",
"trade_date": "2026-05-28",
"margin_purchase_buy": 15234,
"margin_purchase_sell": 14820,
"margin_purchase_balance": 285004,
"short_sale_buy": 3120,
"short_sale_sell": 3388,
"short_sale_balance": 41882,
"source_provider": "twse_official",
"source_role": "official_twse_mi_margn",
"source_lineage": {
"provider": "twse_official",
"family": "official_twse_mi_margn"
},
"data_gaps": [],
"not_investment_advice": true,
"legacy_aliases": {
"symbol": "0050"
}
}
],
"count": 1,
"meta": {
"plan": "pro",
"row_limit": 3,
"is_limited": false
}
}

Field 說明

欄位路徑型別說明
rows[].tickerstring標的代碼。
rows[].marketstring市場別;目前網站僅宣稱 TWSE。
rows[].trade_datestring交易日期(YYYY-MM-DD)。
rows[].margin_purchase_buynumber|null融資買進。
rows[].margin_purchase_sellnumber|null融資賣出。
rows[].margin_purchase_balancenumber|null融資餘額。
rows[].short_sale_buynumber|null融券買進(回補)。
rows[].short_sale_sellnumber|null融券賣出。
rows[].short_sale_balancenumber|null融券餘額。
rows[].source_providerstring來源提供者。
rows[].source_rolestring來源角色。
rows[].source_lineageobject來源血緣;文件與網站文案必須保留。
rows[].data_gapsarray資料缺口訊號。
rows[].not_investment_adviceboolean非投資建議宣告。
countinteger回傳資料筆數。

Usage Notes / 使用建議

  • 目前 coverage 為 2026-03-10..2026-05-28;實際覆蓋筆數與涵蓋股票數詳見 /datasets。
  • TWSE-only、private beta、no TPEx claim。
  • official-first 與 source_lineage/data_gaps 必須保留。
  • ratio tolerance 為 1e-6。
  • daily write cron not enabled。
  • 若需法人淨買賣超補充資料,請搭配 `/v2/datasets/institutional-flow`。

限制與注意

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

Plan Requirement

  • Private beta access
  • Developer
  • Pro
  • Enterprise

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

請求與回應

請求範例

curl --request GET   --url "https://api.twmarketdata.com/v2/datasets/margin-short?symbol=0050&market=TWSE&start_date=2026-03-10&end_date=2026-05-28&limit=3"   --header "X-API-Key: your_api_key_here"

狀態碼

成功回傳融資融券資料

JSON
{  "dataset": "margin_short",  "rows": [    {      "ticker": "0050",      "market": "TWSE",      "trade_date": "2026-05-28",      "margin_purchase_buy": 15234,      "margin_purchase_sell": 14820,      "margin_purchase_balance": 285004,      "short_sale_buy": 3120,      "short_sale_sell": 3388,      "short_sale_balance": 41882,      "source_provider": "twse_official",      "source_role": "official_twse_mi_margn",      "source_lineage": {        "provider": "twse_official",        "family": "official_twse_mi_margn"      },      "data_gaps": [],      "not_investment_advice": true,      "legacy_aliases": {        "symbol": "0050"      }    }  ],  "count": 1,  "meta": {    "plan": "pro",    "row_limit": 3,    "is_limited": false  }}