財務與分析
估值資料
提供台股公司估值相關指標，適合用於估值篩選、相對比較與研究流程。
GET
/v2/datasets/valuation-dataOverview#
估值資料 API 提供台股公司的估值相關指標，適合用於估值篩選、相對比較與研究流程。
資料包含市值、估值比率與企業價值類欄位，可與價格與財報資料共同使用。
- 建立估值篩選條件（例如本益比、股價淨值比、殖利率）。
- 進行同產業或同市場公司的相對估值比較。
- 搭配財報與價格資料做多維度研究分析。
- 在策略或量化流程中加入估值因子。
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/valuations` 為較低層查詢面（ticker/date_from/date_to）。
- 一般產品整合建議優先使用本頁主公開 endpoint `/v2/datasets/valuation-data`。
Plan Requirement#
- Free（限制）
- Developer
- Pro
- Enterprise