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

市場與價格

TWSE 日線價格

提供上市股票日線價格資料，適合用於回測、研究與事件對照流程。

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

GET/v2/datasets/twse-daily-price

Overview

TWSE 日線價格 API 提供上市股票的日線 OHLCV 與成交相關欄位，適合用於回測、價格研究與事件對照。

資料以未還原（unadjusted）日線為主，日期語意採 Asia/Taipei 交易日。

建立上市股票的歷史價格序列。
與公告、事件、財報資料進行時間對齊分析。
作為技術指標或特徵工程的基礎輸入。
在研究流程中快速驗證單一標的近期價格行為。

Coverage

Instruments	Start year	Update timing	Includes delisted
1,682	2004	Not yet available (coming)	✓

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

Request

使用此 endpoint 時，建議：

Query Parameters

欄位	型別	Required	說明
symbol	string	yes	股票代碼（內部對應 ticker）。
start_date	string	no	查詢起始日期（YYYY-MM-DD）。
end_date	string	no	查詢結束日期（YYYY-MM-DD）。
limit	integer	no	回傳筆數（預設 100，最大 5000）。

Response Shape

回應結構固定為 dataset、rows、count，並附 meta（plan/row_limit/is_limited）。

{  "dataset": "twse_daily_price",  "rows": [    {      "symbol": "2330",      "date": "2026-04-22",      "open": 812,      "high": 818,      "low": 808,      "close": 815,      "volume_shares": 18234000,      "turnover_value": 14856300000,      "trade_count": 37842,      "price_change": 6,      "price_change_sign": "+"    }  ],  "count": 1,  "meta": {    "plan": "free",    "row_limit": 50,    "is_limited": false  }}

Field 說明

欄位路徑	型別	說明
rows[].symbol	string	股票代碼。
rows[].date	string	交易日期（YYYY-MM-DD）。
rows[].open	number	開盤價。
rows[].high	number	最高價。
rows[].low	number	最低價。
rows[].close	number	收盤價。
rows[].volume_shares	number	成交股數。
rows[].turnover_value	number\|null	成交金額。
rows[].trade_count	number\|null	成交筆數。
rows[].price_change	number\|null	漲跌價差。
rows[].price_change_sign	string\|null	漲跌符號（+/-）。
count	integer	回傳資料筆數。
meta.plan	string	目前方案代碼。
meta.row_limit	integer	方案每次請求可回傳上限。
meta.is_limited	boolean	是否因方案限制而截斷資料。

Usage Notes / 使用建議

此頁為主公開 endpoint 契約；不要與 legacy/canonical 回應格式混用。
coverage 限制：TPEx 歷史深度目前仍為 deferred，不得視為完整歷史覆蓋。
canonical/supplemental surface 補充：`/v2/datasets/market-prices`。
若需要權值事件調整後序列，請改用對應 adjusted/canonical 路徑。
若需要較低層 canonical payload（含 envelope 與 lineage），請參考「市場價格（Canonical）」與「調整價格（Canonical）」。

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

Free（限制）
Developer
Pro
Enterprise

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

請求與回應

Request example

curl --request GET \  --url "https://api.twmarketdata.com/v2/datasets/twse-daily-price?symbol=2330&start_date=2026-01-01&end_date=2026-04-30&limit=5" \  --header "X-API-Key: your_api_key_here"

Status codes

成功回傳 TWSE 日線資料

JSON

{  "dataset": "twse_daily_price",  "rows": [    {      "symbol": "2330",      "date": "2026-04-22",      "open": 812,      "high": 818,      "low": 808,      "close": 815,      "volume_shares": 18234000,      "turnover_value": 14856300000,      "trade_count": 37842,      "price_change": 6,      "price_change_sign": "+"    }  ],  "count": 1,  "meta": {    "plan": "free",    "row_limit": 50,    "is_limited": false  }}

Overview

TWSE 日線價格 API 提供上市股票的日線 OHLCV 與成交相關欄位，適合用於回測、價格研究與事件對照。

資料以未還原（unadjusted）日線為主，日期語意採 Asia/Taipei 交易日。

建立上市股票的歷史價格序列。

與公告、事件、財報資料進行時間對齊分析。

作為技術指標或特徵工程的基礎輸入。

在研究流程中快速驗證單一標的近期價格行為。

Instruments

Start year

Update timing

Includes delisted

1,682

2004

Not yet available (coming)

✓

欄位

型別

Required

說明

symbol

string

yes

股票代碼（內部對應 ticker）。

start_date

string

查詢起始日期（YYYY-MM-DD）。

end_date

string

查詢結束日期（YYYY-MM-DD）。

limit

integer

回傳筆數（預設 100，最大 5000）。

Response Shape

回應結構固定為 dataset、rows、count，並附 meta（plan/row_limit/is_limited）。

{  "dataset": "twse_daily_price",  "rows": [    {      "symbol": "2330",      "date": "2026-04-22",      "open": 812,      "high": 818,      "low": 808,      "close": 815,      "volume_shares": 18234000,      "turnover_value": 14856300000,      "trade_count": 37842,      "price_change": 6,      "price_change_sign": "+"    }  ],  "count": 1,  "meta": {    "plan": "free",    "row_limit": 50,    "is_limited": false  }}

Field 說明

欄位路徑	型別	說明
rows[].symbol	string	股票代碼。
rows[].date	string	交易日期（YYYY-MM-DD）。
rows[].open	number	開盤價。
rows[].high	number	最高價。
rows[].low	number	最低價。
rows[].close	number	收盤價。
rows[].volume_shares	number	成交股數。
rows[].turnover_value	number\|null	成交金額。
rows[].trade_count	number\|null	成交筆數。
rows[].price_change	number\|null	漲跌價差。
rows[].price_change_sign	string\|null	漲跌符號（+/-）。
count	integer	回傳資料筆數。
meta.plan	string	目前方案代碼。
meta.row_limit	integer	方案每次請求可回傳上限。
meta.is_limited	boolean	是否因方案限制而截斷資料。

Usage Notes / 使用建議

此頁為主公開 endpoint 契約；不要與 legacy/canonical 回應格式混用。

coverage 限制：TPEx 歷史深度目前仍為 deferred，不得視為完整歷史覆蓋。

canonical/supplemental surface 補充：`/v2/datasets/market-prices`。

若需要權值事件調整後序列，請改用對應 adjusted/canonical 路徑。

若需要較低層 canonical payload（含 envelope 與 lineage），請參考「市場價格（Canonical）」與「調整價格（Canonical）」。

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.