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

市場與價格（Canonical）

還原股價

提供 read-time 調整後序列，適合歷史比較與總報酬分析。

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

GET/v2/datasets/adjusted-prices

Overview

adjusted-prices 為 canonical/supplemental 實驗路徑，依賴 market-prices + corporate-actions。

此 route 目前不在 public launch 可公開宣稱可用範圍；僅供契約設計與內部驗證參考。

比較未調整價格與調整後價格。
驗證 split/dividend 等事件對價格序列影響。
在內部流程中直接消費 adjusted canonical envelope。

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

本 route 為 canonical payload，且支援 adjustment_basis。

Query Parameters

欄位	型別	Required	說明
symbol	string	no	股票代碼（例如 2330）。
market	string	no	TWSE 或 TPEx。
date_from	string	no	起始日期（YYYY-MM-DD）。
date_to	string	no	結束日期（YYYY-MM-DD）。
adjustment_basis	string	no	price_only（預設）或 total_return。
limit	integer	no	回傳筆數（預設 100，最大 5000）。

Response Shape

回應為 canonical envelope payload（api_version/endpoint/request_id/.../envelope）。

調整後價格列位於 `envelope.data[]`，包含 adjustment_factor 與 actions_applied。

{  "api_version": "v2",  "endpoint": "/v2/datasets/adjusted-prices",  "request_id": "req_hij321klm654",  "plan_id": "pro",  "dataset": "adjusted_prices",  "query": {    "ticker": "2330",    "market": "TWSE",    "date_from": "2026-01-01",    "date_to": "2026-04-30",    "adjustment_basis": "price_only",    "limit": 10  },  "meta": {    "rows_returned": 1  },  "envelope": {    "api_version": "v2",    "dataset": "adjusted_prices",    "request_context": {      "ticker": "2330",      "as_of_date": "2026-04-30",      "family": "market_technical",      "field_group_type": "adjusted_price_series",      "dataset_view": "adjusted_prices_v3",      "adjustment_basis": "price_only"    },    "data": [      {        "ticker": "2330",        "trade_date": "2026-04-22",        "market": "TWSE",        "close": 815,        "adjusted_close": 790.5,        "adjustment_factor": 0.97,        "adjusted_close_total_return": null,        "adjustment_factor_total_return": null,        "adjustment_factor_actions_v3": 0.97,        "dividend_component": null,        "actions_applied": [          "split"        ],        "actions_excluded": [],        "adjustment_basis": "price_only",        "open": 812,        "high": 818,        "low": 808,        "adjusted_open": 787.64,        "adjusted_high": 793.46,        "adjusted_low": 783.76,        "volume_shares": 18234000,        "adjusted_volume": 18800000,        "source_id": "twse_official",        "quality_flag": "ok"      }    ],    "quality": {      "freshness_state": "fresh",      "freshness_as_of": "2026-04-30",      "completeness_ratio": 1,      "quality_status": "ready"    },    "lineage": {      "source_role": "canonical",      "selected_source": "market_prices_plus_corporate_actions",      "fallback_chain": [        "twse_official",        "tpex_official",        "data_gov_mirror"      ],      "policy_notes": [        "official/public-first canonical"      ]    },    "error": {      "error_code": null,      "error_message": null,      "dataset": "adjusted_prices",      "request_id": "read-api-hij321klm654",      "blocking_gate": null    }  }}

Field 說明

欄位路徑	型別	說明
dataset	string	固定為 adjusted_prices。
query.adjustment_basis	string	調整基準。
envelope.data[].ticker	string	股票代碼。
envelope.data[].trade_date	string	交易日期。
envelope.data[].close	number	原始收盤價。
envelope.data[].adjusted_close	number\|null	調整後收盤價。
envelope.data[].adjustment_factor	number	調整係數。
envelope.data[].actions_applied	array	已套用的公司行動類型。
envelope.data[].actions_excluded	array	排除的行動類型與原因。
envelope.quality.quality_status	string	資料品質狀態。

Usage Notes / 使用建議

此頁為 canonical/supplemental surface，非主產品 endpoint。
公開主張限制：目前不得宣稱 adjusted price 已可用於 production 或 full-market backtest。
若需主公開產品契約，優先使用 twse/tpex 日線主公開 endpoint。
canonical endpoint 使用 `ticker`，與主公開 endpoint `symbol` 命名不同。

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/adjusted-prices?symbol=2330&market=TWSE&date_from=2026-01-01&date_to=2026-04-30&adjustment_basis=price_only&limit=10" \  --header "X-API-Key: your_api_key_here"

Status codes

成功回傳 canonical adjusted-prices payload

JSON

{  "api_version": "v2",  "endpoint": "/v2/datasets/adjusted-prices",  "request_id": "req_hij321klm654",  "plan_id": "pro",  "dataset": "adjusted_prices",  "query": {    "ticker": "2330",    "market": "TWSE",    "date_from": "2026-01-01",    "date_to": "2026-04-30",    "adjustment_basis": "price_only",    "limit": 10  },  "meta": {    "rows_returned": 1  },  "envelope": {    "api_version": "v2",    "dataset": "adjusted_prices",    "request_context": {      "ticker": "2330",      "as_of_date": "2026-04-30",      "family": "market_technical",      "field_group_type": "adjusted_price_series",      "dataset_view": "adjusted_prices_v3",      "adjustment_basis": "price_only"    },    "data": [      {        "ticker": "2330",        "trade_date": "2026-04-22",        "market": "TWSE",        "close": 815,        "adjusted_close": 790.5,        "adjustment_factor": 0.97,        "adjusted_close_total_return": null,        "adjustment_factor_total_return": null,        "adjustment_factor_actions_v3": 0.97,        "dividend_component": null,        "actions_applied": [          "split"        ],        "actions_excluded": [],        "adjustment_basis": "price_only",        "open": 812,        "high": 818,        "low": 808,        "adjusted_open": 787.64,        "adjusted_high": 793.46,        "adjusted_low": 783.76,        "volume_shares": 18234000,        "adjusted_volume": 18800000,        "source_id": "twse_official",        "quality_flag": "ok"      }    ],    "quality": {      "freshness_state": "fresh",      "freshness_as_of": "2026-04-30",      "completeness_ratio": 1,      "quality_status": "ready"    },    "lineage": {      "source_role": "canonical",      "selected_source": "market_prices_plus_corporate_actions",      "fallback_chain": [        "twse_official",        "tpex_official",        "data_gov_mirror"      ],      "policy_notes": [        "official/public-first canonical"      ]    },    "error": {      "error_code": null,      "error_message": null,      "dataset": "adjusted_prices",      "request_id": "read-api-hij321klm654",      "blocking_gate": null    }  }}