EN 登入註冊

AI agent？先讀 /llms.txt 取得全站索引。

市場與價格

估值資料

Name: Valuation data
Creator: TW Market Data
License: https://twmarketdata.com/zh-TW/legal/licensing

估值資料——更完整的逐檔估值紀錄:核心比率加上市值與流通在外股數,每交易日一列。

← 估值資料資料集總覽

衍生來源: TWSE / TPEx / MOPS·方案: free·計費: 2 點·GET /v2/datasets/valuation-data

估值資料是台灣市場資料集,來源為 TWSE / TPEx / MOPS,由 TW Market Data 以 GET /v2/datasets/valuation-data 提供。

總覽

valuation-data 為推導型資料集,在核心估值比率之外,加上每檔股票每交易日的市值與流通在外股數脈絡,係由官方價格與 MOPS 財務輸入計算。lineage 欄位回指上述官方來源,每個數字可重現而非孤立主張。

欄位	型別	說明
`market`	string
`as_of_date`	string
`valuation_version`	string
`pe_ratio`	null
`pb_ratio`	number
`earnings_yield`	null
`book_to_price`	null
`dividend_yield`	number
`market_cap`	null	市值（新台幣,推導）。
`shares_outstanding`	null	計算所用之流通在外股數。
`symbol`	string	股票代碼。
`fundamentals_context`	object

涵蓋範圍

列數	約 7,654,206
涵蓋起訖	2006-01-02 – 2026-09-03
分級	衍生
量測時間	2026-09-04取自資料集登錄表

範例回應

此為本端點的真實回應。資料列位於 "rows" 之下，來源資訊如下方所示；各資料集形狀不盡相同，請以本頁為準。

{
  "dataset": "valuation_data",
  "rows": [
    {
      "market": "TWSE",
      "as_of_date": "2026-08-05",
      "valuation_version": "v1",
      "pe_ratio": null,
      "pb_ratio": 0.77,
      "earnings_yield": null,
      "book_to_price": null,
      "dividend_yield": 3.33,
      "market_cap": null,
      "shares_outstanding": null,
      "provider": "twse_official",
      "source_role": "official_twse_bwibbu",
      "lineage": {
        "row_index": 0,
        "source_hash": "fd14579002ab6ebd9c138ccc167016ef416bcd524b343ea57f6e08ccf545712f",
        "payload_date": "20260805",
        "request_date": "2026-08-05",
        "endpoint_name": "BWIBBU_d",
        "source_authority": "TWSE BWIBBU"
      },
      "updated_at": "2026-08-05T09:01:40.982922",
      "symbol": "1101",
      "fundamentals_context": {
        "generated_at": "2026-08-06T05:15:12Z",
        "ticker": "1101",
        "period": "2026-08-05",
        "period_type": "daily_event",
        "statement_family": "valuation_data",
        "metric_values": {
          "valuation_version": "v1",
          "pe_ratio": null,
          "pb_ratio": 0.77,
          "earnings_yield": null,
          "book_to_price": null,
          "dividend_yield": 3.33,
          "market_cap": null,
          "shares_outstanding": null,
          "updated_at": "2026-08-05T09:01:40.982922",
          "symbol": "1101"
        },
        "source_lineage": {
          "provider": "unknown",
          "source_role": "official_twse_bwibbu",
          "row_index": 0,
          "source_hash": "fd14579002ab6ebd9c138ccc167016ef416bcd524b343ea57f6e08ccf545712f",
          "payload_date": "20260805",
          "request_date": "2026-08-05",
          "endpoint_name": "BWIBBU_d",
          "source_authority": "TWSE BWIBBU"
        },
        "data_gaps": [],
        "restatement_warning": {
          "has_restatement": false,
          "reason": null,
          "previous_version_ref": null
        },
        "not_investment_advice": true,
        "coverage_window": {
          "min_period": null,
          "max_period": null,
          "coverage_confidence": "medium",
          "row_count": 0
        },
        "safe_usage_notes": [
          "not_investment_advice",
          "official_public_first_policy",
          "period_semantics_explicit"
        ],
        "available_tools_or_endpoints": [
          {
            "name": "valuation_data",
            "path": "/v2/datasets/valuation-data"
          }
        ]
      }
    },
    {
      "market": "TWSE",
      "as_of_date": "2026-08-04",
      "valuation_version": "v1",
      "pe_ratio": null,
      "pb_ratio": 0.75,
      "earnings_yield": null,
      "book_to_price": null,
      "dividend_yield": 3.4,
      "market_cap": null,
      "shares_outstanding": null,
      "provider": "twse_official",
      "source_role": "official_twse_bwibbu",
      "lineage": {
        "row_index": 0,
        "source_hash": "f9800a2fef80e7dca37fb3c284adbdc84920b48635e2e5d2a94e191926490712",
        "payload_date": "20260804",
        "request_date": "2026-08-04",
        "endpoint_name": "BWIBBU_d",
        "source_authority": "TWSE BWIBBU"
      },
      "updated_at": "2026-08-05T09:01:40.982922",
      "symbol": "1101",
      "fundamentals_context": {
        "generated_at": "2026-08-06T05:15:12Z",
        "ticker": "1101",
        "period": "2026-08-04",
        "period_type": "daily_event",
        "statement_family": "valuation_data",
        "metric_values": {
          "valuation_version": "v1",
          "pe_ratio": null,
          "pb_ratio": 0.75,
          "earnings_yield": null,
          "book_to_price": null,
          "dividend_yield": 3.4,
          "market_cap": null,
          "shares_outstanding": null,
          "updated_at": "2026-08-05T09:01:40.982922",
          "symbol": "1101"
        },
        "source_lineage": {
          "provider": "unknown",
          "source_role": "official_twse_bwibbu",
          "row_index": 0,
          "source_hash": "f9800a2fef80e7dca37fb3c284adbdc84920b48635e2e5d2a94e191926490712",
          "payload_date": "20260804",
          "request_date": "2026-08-04",
          "endpoint_name": "BWIBBU_d",
          "source_authority": "TWSE BWIBBU"
        },
        "data_gaps": [],
        "restatement_warning": {
          "has_restatement": false,
          "reason": null,
          "previous_version_ref": null
        },
        "not_investment_advice": true,
        "coverage_window": {
          "min_period": null,
          "max_period": null,
          "coverage_confidence": "medium",
          "row_count": 0
        },
        "safe_usage_notes": [
          "not_investment_advice",
          "official_public_first_policy",
          "period_semantics_explicit"
        ],
        "available_tools_or_endpoints": [
          {
            "name": "valuation_data",
            "path": "/v2/datasets/valuation-data"
          }
        ]
      }
    }
  ],
  "count": 50,
  "status": "ok"
}

擷取自 2026-07-20 的線上 API。

出處

以下欄位會隨資料一併回傳,記錄這一列的來源。它們屬於出處而非本資料集要講的事實,因此列在這裡而不進欄位表。

providersource_rolelineageupdated_at

授權與顯名

本服務部分資料取自政府資料開放平臺(data.gov.tw),依「政府資料開放授權條款-第1版」授權利用。資料提供機關:臺灣證券交易所、證券櫃檯買賣中心、臺灣期貨交易所、臺灣集中保管結算所、國家發展委員會、中央銀行、經濟部統計處、財政部關務署。本服務之加值處理、衍生計算與呈現方式由 TWMD 負責,與各資料提供機關無涉。

引用此資料集

TW Market Data. (n.d.). 估值資料 [Data set]. TW Market Data. Retrieved 2026-09-05, from https://twmarketdata.com/zh-TW/docs/api/market-prices/valuation-data

版本取自資料集自己的 as_of，不是這一頁的產生日期。沒有 as_of 的資料集就不列這個欄位，不會補一個看起來合理的值。驗證簽章

可與本資料集對齊的其他資料集。每組都標出可用來 join 的欄位,規劃跨表查詢時不必自己猜。

個股市值權重
可用 as_of_date + market + ticker 對齊
技術指標
可用 as_of_date + market + ticker 對齊
期貨市場日資料
可用 as_of_date + market + ticker 對齊
GHG 碳揭露（範疇1/2/3）
可用 as_of_date + market + ticker 對齊
財務比率指標
可用 as_of_date + market + ticker 對齊

快速開始

把你的金鑰放進 X-API-Key 標頭。
加上查詢參數（symbol、日期區間、limit）。
送出請求並讀取 rows 陣列。

curl "https://api.twmarketdata.com/v2/datasets/valuation-data?symbol=1101" \
  -H "X-API-Key: sk_live_..."

篩選參數

參數	必填	型別	說明
`symbol`	是	string	股票代碼，例如 2330。
`start_date`	否	string (YYYY-MM-DD)	查詢起始日期。
`end_date`	否	string (YYYY-MM-DD)	查詢結束日期。
`limit`	否	integer	回傳筆數上限。

Python 範例

import requests

resp = requests.get(
    "https://api.twmarketdata.com/v2/datasets/valuation-data",
    params={"symbol": "1101"},
    headers={"X-API-Key": "sk_live_..."},
)
resp.raise_for_status()
print(resp.json()["rows"])

OpenAPI

此端點為 GET /v2/datasets/valuation-data。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。

備註與限制

推導而非官方揭露:市值與比率結合官方價格與具時間點敏感性的股數與財務數字,該等數字會重編——回測請固定 as_of,使過去估值僅採用當下已公開的數字。

請求與回應

請求

curl "https://api.twmarketdata.com/v2/datasets/valuation-data?symbol=2330&start_date=2026-01-01&end_date=2026-06-30&limit=5" \
  -H "X-API-Key: $TWMD_API_KEY"

回應

{
  "dataset": "valuation_data",
  "rows": [
    {
      "market": "<string>",
      "as_of_date": "<string>",
      "valuation_version": "<string>",
      "pe_ratio": "<null>",
      "pb_ratio": "<number>",
      "earnings_yield": "<null>",
      "book_to_price": "<null>",
      "dividend_yield": "<number>",
      "market_cap": "<null>",
      "shares_outstanding": "<null>",
      "provider": "<string>",
      "source_role": "<string>",
      "lineage": {
        "row_index": "<number>",
        "source_hash": "<string>",
        "payload_date": "<string>",
        "request_date": "<string>",
        "endpoint_name": "<string>",
        "source_authority": "<string>"
      },
      "updated_at": "<string>",
      "symbol": "<string>",
      "fundamentals_context": {
        "generated_at": "<string>",
        "ticker": "<string>",
        "period": "<string>",
        "period_type": "<string>",
        "statement_family": "<string>",
        "metric_values": "<object>",
        "source_lineage": "<object>",
        "data_gaps": "<array>",
        "restatement_warning": "<object>",
        "not_investment_advice": "<boolean>",
        "coverage_window": "<object>",
        "safe_usage_notes": "<array>",
        "available_tools_or_endpoints": "<array>"
      }
    }
  ],
  "count": 50,
  "status": "ok"
}