Building an AI agent? Start with /llms.txt for the full site index.

Preview

市場新聞

提供市場新聞摘要資料（Preview），用於市場狀態追蹤與研究背景補充。

This documentation page is currently available in Chinese only; English versions are coming soon.

GET/v2/datasets/market-news

Overview

市場新聞目前為 Preview 能力，提供市場層級摘要欄位。

內容採 snapshot 摘要語氣，不宣稱即時新聞。

市場背景補充
研究筆記與事件索引
與市場指標資料交叉對照

Coverage

Instruments	Start year	Update timing	Includes delisted
Not yet available (coming)	Not yet available (coming)	Not yet available (coming)	coming

Figures are measured from the DB; unlisted fields defer to docs coverage (coming) — we don't fabricate cell by cell.

Request

可依日期區間與市場別過濾。

Query Parameters

欄位	型別	Required	說明
start_date	string	no	起始日期。
end_date	string	no	結束日期。
market	string	no	市場代碼。
limit	integer	no	回傳筆數上限。

Response Shape

回應僅包含摘要欄位，不回傳 raw payload。

{  "dataset": "market_news",  "rows": [    {      "published_at": "2026-05-06T09:00:00+08:00",      "title": "市場指數與類股資料以快照方式整理",      "source_name": "TWSE",      "news_type": "市場概況",      "market": "TW"    }  ],  "count": 1}

Field 說明

欄位路徑	型別	說明
rows[].published_at	string	發布時間。
rows[].title	string	新聞標題摘要。
rows[].source_name	string	來源標記。
rows[].news_type	string\|null	分類標記。
rows[].market	string\|null	市場代碼。

Usage Notes / 使用建議

Preview 階段可能調整欄位與配額。
資料來源不可用時，系統可能回傳空集合。

Limitations & notes

Coverage is not the full market or full history; the actual range is defined by the coverage table above and the data_gaps in the response.
Missing data is flagged honestly — we don't fill gaps with estimated values.
The platform focuses on daily-frequency and fundamental data; it does not provide real-time quotes, intraday bars, or cryptocurrencies.
TWSE is the verified baseline; TPEx history depth and adjusted prices are currently beta / deferred, flagged per dataset.

Plan Requirement

Preview 能力（受控開放）
實際可用範圍以控制台方案顯示為準

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

請求與回應

Request example

curl --request GET \  --url "https://api.twmarketdata.com/v2/datasets/market-news?limit=10" \  --header "X-API-Key: your_api_key_here"

Status codes

成功回傳市場新聞摘要

JSON

{  "dataset": "market_news",  "rows": [    {      "published_at": "2026-05-06T09:00:00+08:00",      "title": "市場指數與類股資料以快照方式整理",      "source_name": "TWSE",      "news_type": "市場概況",      "market": "TW"    }  ],  "count": 1}

Instruments

Start year

Update timing

Includes delisted

Not yet available (coming)

coming

欄位

型別

Required

說明

start_date

string

起始日期。

end_date

string

結束日期。

market

string

市場代碼。

limit

integer

回傳筆數上限。

Response Shape

回應僅包含摘要欄位，不回傳 raw payload。

{  "dataset": "market_news",  "rows": [    {      "published_at": "2026-05-06T09:00:00+08:00",      "title": "市場指數與類股資料以快照方式整理",      "source_name": "TWSE",      "news_type": "市場概況",      "market": "TW"    }  ],  "count": 1}

欄位路徑

型別

說明

rows[].published_at

string

發布時間。

rows[].title

string

新聞標題摘要。

rows[].source_name

string

來源標記。

rows[].news_type

string|null

分類標記。

rows[].market

string|null

市場代碼。

Limitations & notes

Coverage is not the full market or full history; the actual range is defined by the coverage table above and the data_gaps in the response.

Missing data is flagged honestly — we don't fill gaps with estimated values.

The platform focuses on daily-frequency and fundamental data; it does not provide real-time quotes, intraday bars, or cryptocurrencies.

TWSE is the verified baseline; TPEx history depth and adjusted prices are currently beta / deferred, flagged per dataset.