市場資料

技術指標

Technical Stage0 baseline（TWSE only / Non-TPEx），覆蓋至 2026-05-11；Stage1（RSI / MACD）尚未納入 production baseline。

GET/v2/datasets/technical-indicators

Overview#

Technical Indicators 目前文件對齊的是 Technical Stage0 approved baseline。

此 baseline 為 TWSE only / Non-TPEx，範圍覆蓋至 2026-05-11，且不包含 Stage1 指標（RSI / MACD）。

以 Stage0 欄位建立可重跑的日頻特徵流程。
搭配價格資料做報酬、趨勢與波動分析。
作為研究與回測前處理特徵層（非即時交易訊號）。

Request#

使用此 endpoint 時，建議：

Query Parameters#

欄位	型別	Required	說明
ticker / symbol	string	yes	股票代碼（建議使用 ticker；若現有 SDK 使用 symbol，沿用現有命名）。
start_date	string	no	查詢起始日期（YYYY-MM-DD）。
end_date	string	no	查詢結束日期（YYYY-MM-DD）。
market	string	no	市場代碼（目前 Stage0 baseline 為 TWSE）。
indicator_basis	string	no	指標基礎（目前 baseline 為 close）。
provider	string	no	來源 provider（若現有路由支援，可作為輔助條件）。
source_role	string	no	來源角色（若現有路由支援，可作為輔助條件）。
limit	integer	no	回傳筆數限制。

Response Shape#

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

Stage0 approved baseline coverage（TWSE only）

- Older: 2023-06-01..2024-03-31 = 176,750 rows

- Main baseline: 2024-04-01..2025-03-31 = 220,997 rows

- Newer recut: 2025-04-01..2026-05-11 = 217,890 rows

- Total: 615,637 rows

{  "dataset": "technical_indicators",  "rows": [    {      "ticker": "2330",      "market": "TWSE",      "trade_date": "2026-04-22",      "close": 815,      "volume": 18234000,      "daily_return": 0.00492611,      "ma_5": 809.4,      "ma_20": 796.8,      "ma_60": 772.1,      "volume_avg_20": 16852340.2,      "return_5d": 0.0175,      "return_20d": 0.0513,      "volatility_20d": 0.0142,      "provider": "twse",      "source_role": "derived_from_twse_price",      "indicator_basis": "close",      "feature_set": "stage0",      "formula_version": "stage0_v1"    }  ],  "count": 1}

Field 說明#

欄位路徑	型別	說明
rows[].ticker	string	股票代碼。
rows[].market	string	市場代碼（目前 baseline 為 TWSE）。
rows[].trade_date	string	資料日期（交易日語意，Asia/Taipei）。
rows[].close	number	收盤價。
rows[].volume	number\|null	成交量。
rows[].daily_return	number\|null	單日報酬率。
rows[].ma_5	number\|null	5 日均線。
rows[].ma_20	number\|null	20 日均線。
rows[].ma_60	number\|null	60 日均線。
rows[].volume_avg_20	number\|null	20 日平均成交量。
rows[].return_5d	number\|null	5 日報酬率。
rows[].return_20d	number\|null	20 日報酬率。
rows[].volatility_20d	number\|null	20 日波動度。
rows[].provider	string	資料 provider（baseline: twse）。
rows[].source_role	string	資料來源角色（baseline: derived_from_twse_price）。
rows[].indicator_basis	string	指標基礎（baseline: close）。
rows[].feature_set	string	特徵集合版本（baseline: stage0）。
rows[].formula_version	string	公式版本（baseline: stage0_v1）。
rows[].lineage	object\|null	資料血緣（若當前路由有回傳）。
rows[].data_gaps	object\|null	資料缺口描述（若當前路由有回傳）。
count	integer	回傳資料筆數。

Usage Notes / 使用建議#

Stage0 baseline 目前為 TWSE only / Non-TPEx，請勿將此頁解讀為 TPEx technical coverage。
Deferred：RSI / MACD / Stage1 advanced indicators 尚未納入目前 Stage0 production baseline。
Known gap：2026-05-12..2026-05-15（upstream price dependency gap），不計入目前 approved baseline coverage。
本資料為日頻衍生資料，不應宣稱 real-time。
技術欄位受 lookback 視窗影響，序列前段可能出現 null。

Plan Requirement#

Free（限制）
Developer
Pro
Enterprise

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

請求與回應

請求範例

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

狀態碼

成功回傳技術指標資料

JSON

{  "dataset": "technical_indicators",  "rows": [    {      "ticker": "2330",      "market": "TWSE",      "trade_date": "2026-04-22",      "close": 815,      "volume": 18234000,      "daily_return": 0.00492611,      "ma_5": 809.4,      "ma_20": 796.8,      "ma_60": 772.1,      "volume_avg_20": 16852340.2,      "return_5d": 0.0175,      "return_20d": 0.0513,      "volatility_20d": 0.0142,      "provider": "twse",      "source_role": "derived_from_twse_price",      "indicator_basis": "close",      "feature_set": "stage0",      "formula_version": "stage0_v1"    }  ],  "count": 1}