Preview

市場新聞

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

GET/v2/datasets/market-news

Overview#

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

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

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

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 階段可能調整欄位與配額。
資料來源不可用時，系統可能回傳空集合。

Plan Requirement#

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

請求與回應

請求範例

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

狀態碼

成功回傳市場新聞摘要

JSON

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

欄位

型別

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

市場代碼。