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

財務與成長（Canonical）

估值資料（Canonical）

canonical/supplemental 估值查詢面，適用於低階契約與資料對齊流程。

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

GET/v2/datasets/valuation-core-daily

Overview

valuations 是 canonical/supplemental surface，提供估值核心欄位的低階 envelope。

此 route 不是主公開產品頁；對外整合優先使用 `/v2/datasets/valuation-data`。

內部資料對齊與估值核心欄位驗證。
需要直接讀取 canonical envelope 與 lineage 時。
補充 productized endpoint 之外的低階資料查詢。

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 契約，參數與回應格式與主公開 endpoint 不同。

Query Parameters

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

Response Shape

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

估值資料列位於 `envelope.data[]`，非 productized endpoint 的 `rows`。

{  "api_version": "v2",  "endpoint": "/v2/datasets/valuation-core-daily",  "request_id": "req_def456ghi789",  "plan_id": "free",  "dataset": "valuation_core_daily",  "query": {    "ticker": "2330",    "date_from": "2026-01-01",    "date_to": "2026-04-30",    "limit": 10  },  "meta": {    "rows_returned": 1  },  "envelope": {    "api_version": "v2",    "dataset": "valuations",    "data": [      {        "ticker": "2330",        "valuation_date": "2026-04-22",        "pe_ratio": 25.3,        "pb_ratio": 6.7,        "dividend_yield": 0.018,        "market_cap": 21050000000000,        "eps": null,        "currency": "TWD",        "source_id": "mops_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": "mops_official",      "fallback_chain": [        "data_gov_mirror",        "finmind_legacy"      ],      "policy_notes": [        "official/public-first canonical"      ]    },    "error": {      "error_code": null,      "error_message": null,      "dataset": "valuations",      "request_id": "read-api-def456ghi789",      "blocking_gate": null    }  }}

Field 說明

欄位路徑	型別	說明
dataset	string	固定為 valuations。
query.ticker	string\|null	查詢 ticker。
envelope.data[].valuation_date	string	估值資料日期。
envelope.data[].pe_ratio	number\|null	本益比。
envelope.data[].pb_ratio	number\|null	股價淨值比。
envelope.data[].dividend_yield	number\|null	殖利率。
envelope.data[].market_cap	number\|null	市值。
envelope.quality.quality_status	string	資料品質狀態。
envelope.lineage.selected_source	string	選用來源。

Usage Notes / 使用建議

此頁為 canonical/supplemental surface，非主產品 endpoint。
主公開對外建議：`/v2/datasets/valuation-data`（symbol + dataset/rows/count）。
canonical endpoint 使用 `ticker` 參數，請勿視為主 endpoint 的替代叫法。

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-core-daily?symbol=2330&date_from=2026-01-01&date_to=2026-04-30&limit=10" \  --header "X-API-Key: your_api_key_here"

Status codes

成功回傳 canonical valuations payload

JSON

{  "api_version": "v2",  "endpoint": "/v2/datasets/valuation-core-daily",  "request_id": "req_def456ghi789",  "plan_id": "free",  "dataset": "valuation_core_daily",  "query": {    "ticker": "2330",    "date_from": "2026-01-01",    "date_to": "2026-04-30",    "limit": 10  },  "meta": {    "rows_returned": 1  },  "envelope": {    "api_version": "v2",    "dataset": "valuations",    "data": [      {        "ticker": "2330",        "valuation_date": "2026-04-22",        "pe_ratio": 25.3,        "pb_ratio": 6.7,        "dividend_yield": 0.018,        "market_cap": 21050000000000,        "eps": null,        "currency": "TWD",        "source_id": "mops_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": "mops_official",      "fallback_chain": [        "data_gov_mirror",        "finmind_legacy"      ],      "policy_notes": [        "official/public-first canonical"      ]    },    "error": {      "error_code": null,      "error_message": null,      "dataset": "valuations",      "request_id": "read-api-def456ghi789",      "blocking_gate": null    }  }}

Overview

valuations 是 canonical/supplemental surface，提供估值核心欄位的低階 envelope。

此 route 不是主公開產品頁；對外整合優先使用 `/v2/datasets/valuation-data`。

內部資料對齊與估值核心欄位驗證。

需要直接讀取 canonical envelope 與 lineage 時。

補充 productized endpoint 之外的低階資料查詢。

Instruments

Start year

Update timing

Includes delisted

Not yet available (coming)

coming

欄位

型別

Required

說明

symbol

string

股票代碼（例如 2330）。

date_from

string

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

date_to

string

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

limit

integer

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

Response Shape

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

估值資料列位於 `envelope.data[]`，非 productized endpoint 的 `rows`。

{  "api_version": "v2",  "endpoint": "/v2/datasets/valuation-core-daily",  "request_id": "req_def456ghi789",  "plan_id": "free",  "dataset": "valuation_core_daily",  "query": {    "ticker": "2330",    "date_from": "2026-01-01",    "date_to": "2026-04-30",    "limit": 10  },  "meta": {    "rows_returned": 1  },  "envelope": {    "api_version": "v2",    "dataset": "valuations",    "data": [      {        "ticker": "2330",        "valuation_date": "2026-04-22",        "pe_ratio": 25.3,        "pb_ratio": 6.7,        "dividend_yield": 0.018,        "market_cap": 21050000000000,        "eps": null,        "currency": "TWD",        "source_id": "mops_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": "mops_official",      "fallback_chain": [        "data_gov_mirror",        "finmind_legacy"      ],      "policy_notes": [        "official/public-first canonical"      ]    },    "error": {      "error_code": null,      "error_message": null,      "dataset": "valuations",      "request_id": "read-api-def456ghi789",      "blocking_gate": null    }  }}

Field 說明

欄位路徑	型別	說明
dataset	string	固定為 valuations。
query.ticker	string\|null	查詢 ticker。
envelope.data[].valuation_date	string	估值資料日期。
envelope.data[].pe_ratio	number\|null	本益比。
envelope.data[].pb_ratio	number\|null	股價淨值比。
envelope.data[].dividend_yield	number\|null	殖利率。
envelope.data[].market_cap	number\|null	市值。
envelope.quality.quality_status	string	資料品質狀態。
envelope.lineage.selected_source	string	選用來源。

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.

{ "api_version": "v2", "endpoint": "/v2/datasets/valuation-core-daily", "request_id": "req_def456ghi789", "plan_id": "free", "dataset": "valuation_core_daily", "query": { "ticker": "2330", "date_from": "2026-01-01", "date_to": "2026-04-30", "limit": 10 }, "meta": { "rows_returned": 1 }, "envelope": { "api_version": "v2", "dataset": "valuations", "data": [ { "ticker": "2330", "valuation_date": "2026-04-22", "pe_ratio": 25.3, "pb_ratio": 6.7, "dividend_yield": 0.018, "market_cap": 21050000000000, "eps": null, "currency": "TWD", "source_id": "mops_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": "mops_official", "fallback_chain": [ "data_gov_mirror", "finmind_legacy" ], "policy_notes": [ "official/public-first canonical" ] }, "error": { "error_code": null, "error_message": null, "dataset": "valuations", "request_id": "read-api-def456ghi789", "blocking_gate": null } }}