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

財務與分析

估值資料

提供台股公司估值相關指標，適合用於估值篩選、相對比較與研究流程。

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

GET/v2/datasets/valuation-data

Overview

估值資料 API 提供台股公司的估值相關指標，適合用於估值篩選、相對比較與研究流程。

資料包含市值、估值比率與企業價值類欄位，可與價格與財報資料共同使用。

建立估值篩選條件（例如本益比、股價淨值比、殖利率）。
進行同產業或同市場公司的相對估值比較。
搭配財報與價格資料做多維度研究分析。
在策略或量化流程中加入估值因子。

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

使用此 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	回傳筆數限制。

Response Shape

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

{  "dataset": "valuation_data",  "rows": [    {      "symbol": "2330",      "date": "2026-04-22",      "market_cap": 21050000000000,      "pe_ratio": 25.3,      "pb_ratio": 6.7,      "dividend_yield": 0.018,      "enterprise_value": 20900000000000,      "ev_to_ebitda": 17.2,      "price_to_sales": 9.4    }  ],  "count": 1}

Field 說明

欄位路徑	型別	說明
rows[].symbol	string	股票代碼。
rows[].date	string	資料日期（交易日語意）。
rows[].market_cap	number\|null	市值。
rows[].pe_ratio	number\|null	本益比（PE）。
rows[].pb_ratio	number\|null	股價淨值比（PB）。
rows[].dividend_yield	number\|null	殖利率。
rows[].enterprise_value	number\|null	企業價值（EV）。
rows[].ev_to_ebitda	number\|null	EV / EBITDA。
rows[].price_to_sales	number\|null	市銷率（P/S）。
count	integer	回傳資料筆數。

Usage Notes / 使用建議

估值欄位可能受價格波動與財報更新時點影響。
跨標的比較前，建議固定同一日期區間。
若欄位為 null，通常代表當期無法穩定計算，不建議直接補零。
日期以 Asia/Taipei 交易日語意（YYYY-MM-DD）為準。
Canonical 補充：`/v2/datasets/valuation-core-daily` 為較低層查詢面（ticker/date_from/date_to）。
一般產品整合建議優先使用本頁主公開 endpoint `/v2/datasets/valuation-data`。

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/valuation-data?symbol=2330&start_date=2026-01-01&end_date=2026-04-30&limit=60" \  --header "X-API-Key: your_api_key_here"

Status codes

成功回傳估值資料

JSON

{  "dataset": "valuation_data",  "rows": [    {      "symbol": "2330",      "date": "2026-04-22",      "market_cap": 21050000000000,      "pe_ratio": 25.3,      "pb_ratio": 6.7,      "dividend_yield": 0.018,      "enterprise_value": 20900000000000,      "ev_to_ebitda": 17.2,      "price_to_sales": 9.4    }  ],  "count": 1}

Overview

估值資料 API 提供台股公司的估值相關指標，適合用於估值篩選、相對比較與研究流程。

資料包含市值、估值比率與企業價值類欄位，可與價格與財報資料共同使用。

建立估值篩選條件（例如本益比、股價淨值比、殖利率）。

進行同產業或同市場公司的相對估值比較。

搭配財報與價格資料做多維度研究分析。

在策略或量化流程中加入估值因子。

Instruments

Start year

Update timing

Includes delisted

Not yet available (coming)

coming

欄位

型別

Required

說明

symbol

string

yes

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

start_date

string

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

end_date

string

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

limit

integer

回傳筆數限制。

Response Shape

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

{  "dataset": "valuation_data",  "rows": [    {      "symbol": "2330",      "date": "2026-04-22",      "market_cap": 21050000000000,      "pe_ratio": 25.3,      "pb_ratio": 6.7,      "dividend_yield": 0.018,      "enterprise_value": 20900000000000,      "ev_to_ebitda": 17.2,      "price_to_sales": 9.4    }  ],  "count": 1}

Field 說明

欄位路徑	型別	說明
rows[].symbol	string	股票代碼。
rows[].date	string	資料日期（交易日語意）。
rows[].market_cap	number\|null	市值。
rows[].pe_ratio	number\|null	本益比（PE）。
rows[].pb_ratio	number\|null	股價淨值比（PB）。
rows[].dividend_yield	number\|null	殖利率。
rows[].enterprise_value	number\|null	企業價值（EV）。
rows[].ev_to_ebitda	number\|null	EV / EBITDA。
rows[].price_to_sales	number\|null	市銷率（P/S）。
count	integer	回傳資料筆數。

Usage Notes / 使用建議

估值欄位可能受價格波動與財報更新時點影響。

跨標的比較前，建議固定同一日期區間。

若欄位為 null，通常代表當期無法穩定計算，不建議直接補零。

日期以 Asia/Taipei 交易日語意（YYYY-MM-DD）為準。

Canonical 補充：`/v2/datasets/valuation-core-daily` 為較低層查詢面（ticker/date_from/date_to）。

一般產品整合建議優先使用本頁主公開 endpoint `/v2/datasets/valuation-data`。

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.