TW Market Data LogoTW Market Data

核心資料

市場與價格

TWSE / TPEx 日線、還原價格、指數與市場廣度

財務與成長

月營收、財報三表、財務指標與估值資料

籌碼與資金

三大法人與融資融券資料

公司與結構

公司與事件

公司基本資料、公告、事件、公司行動與股利

分類與結構

主題分類、指數分類與跨資料集 mapping

策略與量化

Features、Factor Data、Time Alignment 與 Screener

平台能力

API 存取

REST API、認證與第一個 request

查詢與工具

Search API、Query API、欄位清單與查詢範例

Tools / MCP

Agent workflow、MCP tools 與 OpenAPI 入口

方案價格文件觀點文章
EN儀表板

TW Market Data(TWMD)提供之歷史資料與統計,非投資建議;投資決策與風險由您自行判斷。

隱私政策|服務條款|幫助中心||EN|TW Market Data © 2026

文件總覽

DASHBOARD

儀表板定價

FOR AI AGENTS

MCP Serverllms.txt工具清單OpenAPI SpecAgent 工作流範例
Webhooks建置中

OVERVIEW

總覽快速開始認證來源政策資料分級資料血緣市場覆蓋

DATA APIS

指數資料市場指數整合日線價格TPEx 日線價格TWSE 日線價格除權除息價格調整因子漲跌停價日線報酬指數日線還原價格指數成分股市場廣度核心估值日線估值資料技術指標指數分類市場概況快照

GUIDES

如何取得財報三表如何查三大法人籌碼如何看市場狀態如何接策略・AI Agent

SDKS

Release StatusPython SDKJavaScript / TypeScript SDK

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

市場與價格

核心估值日線

核心估值日線——每檔股票每交易日的核心估值比率(本益比、股價淨值比、殖利率)。

衍生來源: TWSE / TPEx·方案: pro·計費: 2 點·GET /v2/datasets/valuation-core-daily

總覽

valuation-core-daily 為推導型資料集:結合官方日價格與每股盈餘、每股淨值及股利輸入,得出每檔股票每交易日的核心估值比率。lineage 欄位標明每個比率的計算來源,估值可稽核而非黑箱。

欄位型別說明
symbolstring股票代碼。
datestring交易日。
pernumber本益比(推導)。
pbrnumber股價淨值比(推導)。
dividend_yieldnumber殖利率(比值,推導)。
source_rolestring正規來源角色(derived_valuation_core)。

涵蓋範圍

列數704,522
涵蓋起訖2023-06-01 至 2026-05-28
分級衍生

範例回應

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

{  "api_version": "v2",  "dataset": "valuation_core_daily",  "dataset_version": "v2.0.0-preview",  "release_version": "v2.2026-05-28.preview",  "release_date": "2026-05-28",  "data_as_of": "2026-05-28",  "request_context": {    "ticker": "1101",    "as_of_date": "2026-05-28",    "family": "fundamentals",    "field_group_type": "canonical",    "dataset_view": "valuation_core_daily_v1",    "source_table": "valuation_core_daily",    "scope": "valuation_core_daily_only",    "coverage_type": "seeded_anchor_snapshot_set",    "supported_sort_by": [      "date"    ],    "supported_filter_fields": [      "ticker",      "date_from",      "date_to"    ],    "date_range": {      "date_from": null,      "date_to": null    }  },  "data": [    {      "ticker": "1101",      "date": "2026-05-28",      "close": 23.65,      "shares_outstanding": null,      "market_cap": null,      "trailing_12m_revenue": null,      "ps": null,      "book_value_per_share": null,      "pe": null,      "pb": 0.75,      "dividend_per_share_ttm": null,      "dividend_yield": 3.38,      "source_summary": {        "pb": "valuation_data_items",        "pe": "missing",        "ps": "missing_direct_source",        "close": "technical_indicators_items",        "market_cap": "missing_direct_source",        "dividend_yield": "valuation_data_items",        "shares_outstanding": "missing_direct_source",        "book_value_per_share": "missing_source_gap",        "trailing_12m_revenue": "missing_source_gap"      },      "notes": "missing_dependencies=shares_outstanding,market_cap,ps,book_value_per_share,trailing_12m_revenue"    },    {      "ticker": "1102",      "date": "2026-05-28",      "close": 32.4,      "shares_outstanding": null,      "market_cap": null,      "trailing_12m_revenue": null,      "ps": null,      "book_value_per_share": null,      "pe": 10.87,      "pb": 0.65,      "dividend_per_share_ttm": null,      "dividend_yield": 7.1,      "source_summary": {        "pb": "valuation_data_items",        "pe": "valuation_data_items",        "ps": "missing_direct_source",        "close": "technical_indicators_items",        "market_cap": "missing_direct_source",        "dividend_yield": "valuation_data_items",        "shares_outstanding": "missing_direct_source",        "book_value_per_share": "missing_source_gap",        "trailing_12m_revenue": "missing_source_gap"      },      "notes": "missing_dependencies=shares_outstanding,market_cap,ps,book_value_per_share,trailing_12m_revenue"    }  ],  "quality": {    "freshness_state": "fresh",    "freshness_as_of": "2026-05-28",    "completeness_ratio": 1,    "quality_status": "ready"  },  "lineage": {    "source_role": "canonical",    "selected_source": "valuation_core_daily",    "fallback_chain": [      "valuation_data_items",      "financial_metrics_items",      "ticker_metadata"    ],    "policy_notes": [      "official/public-first canonical",      "valuation_core_daily is the seeded anchor surface for valuation facts",      "raw_payload excluded from the public read route"    ]  },  "error": {    "error_code": null,    "error_message": null,    "dataset": "valuation_core_daily",    "request_id": "read-api-20260528",    "blocking_gate": null  },  "dataset_id": "valuation_core_daily",  "data_count": 50,  "known_gaps": [    "raw_payload_excluded",    "not_investment_advice"  ],  "warnings": [    "not_investment_advice",    "raw_payload_excluded"  ]}

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

快速開始

  1. 把你的金鑰放進 X-API-Key 標頭。
  2. 加上查詢參數(symbol、日期區間、limit)。
  3. 送出請求並讀取 data 陣列。
curl "https://api.twmarketdata.com/v2/datasets/valuation-core-daily?symbol=2330" \  -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-core-daily",    params={"symbol": "2330"},    headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json()["data"])

帶日期區間篩選:

import requests # The full verified example — the same call with every supported filter set.resp = requests.get(    "https://api.twmarketdata.com/v2/datasets/valuation-core-daily",    params={"symbol": "2330"},    headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()for row in resp.json()["data"]:    print(row)

OpenAPI

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

備註與限制

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

請求與回應

請求

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

以 X-API-Key 標頭認證,使用儀表板發放的 sk_live_ 金鑰。

回應

JSON
{  "api_version": "v2",  "dataset": "valuation_core_daily",  "dataset_version": "v2.0.0-preview",  "release_version": "v2.2026-05-28.preview",  "release_date": "2026-05-28",  "data_as_of": "2026-05-28",  "request_context": {    "ticker": "1101",    "as_of_date": "2026-05-28",    "family": "fundamentals",    "field_group_type": "canonical",    "dataset_view": "valuation_core_daily_v1",    "source_table": "valuation_core_daily",    "scope": "valuation_core_daily_only",    "coverage_type": "seeded_anchor_snapshot_set",    "supported_sort_by": [      "date"    ],    "supported_filter_fields": [      "ticker",      "date_from",      "date_to"    ],    "date_range": {      "date_from": null,      "date_to": null    }  },  "data": [    {      "ticker": "1101",      "date": "2026-05-28",      "close": 23.65,      "shares_outstanding": null,      "market_cap": null,      "trailing_12m_revenue": null,      "ps": null,      "book_value_per_share": null,      "pe": null,      "pb": 0.75,      "dividend_per_share_ttm": null,      "dividend_yield": 3.38,      "source_summary": {        "pb": "valuation_data_items",        "pe": "missing",        "ps": "missing_direct_source",        "close": "technical_indicators_items",        "market_cap": "missing_direct_source",        "dividend_yield": "valuation_data_items",        "shares_outstanding": "missing_direct_source",        "book_value_per_share": "missing_source_gap",        "trailing_12m_revenue": "missing_source_gap"      },      "notes": "missing_dependencies=shares_outstanding,market_cap,ps,book_value_per_share,trailing_12m_revenue"    },    {      "ticker": "1102",      "date": "2026-05-28",      "close": 32.4,      "shares_outstanding": null,      "market_cap": null,      "trailing_12m_revenue": null,      "ps": null,      "book_value_per_share": null,      "pe": 10.87,      "pb": 0.65,      "dividend_per_share_ttm": null,      "dividend_yield": 7.1,      "source_summary": {        "pb": "valuation_data_items",        "pe": "valuation_data_items",        "ps": "missing_direct_source",        "close": "technical_indicators_items",        "market_cap": "missing_direct_source",        "dividend_yield": "valuation_data_items",        "shares_outstanding": "missing_direct_source",        "book_value_per_share": "missing_source_gap",        "trailing_12m_revenue": "missing_source_gap"      },      "notes": "missing_dependencies=shares_outstanding,market_cap,ps,book_value_per_share,trailing_12m_revenue"    }  ],  "quality": {    "freshness_state": "fresh",    "freshness_as_of": "2026-05-28",    "completeness_ratio": 1,    "quality_status": "ready"  },  "lineage": {    "source_role": "canonical",    "selected_source": "valuation_core_daily",    "fallback_chain": [      "valuation_data_items",      "financial_metrics_items",      "ticker_metadata"    ],    "policy_notes": [      "official/public-first canonical",      "valuation_core_daily is the seeded anchor surface for valuation facts",      "raw_payload excluded from the public read route"    ]  },  "error": {    "error_code": null,    "error_message": null,    "dataset": "valuation_core_daily",    "request_id": "read-api-20260528",    "blocking_gate": null  },  "dataset_id": "valuation_core_daily",  "data_count": 50,  "known_gaps": [    "raw_payload_excluded",    "not_investment_advice"  ],  "warnings": [    "not_investment_advice",    "raw_payload_excluded"  ]}

擷取自對此端點的真實呼叫,非手寫。

此資料集的資料列在 "data" 之下。各資料集的信封不同,請以本頁為準,勿沿用其他頁的形狀。

本頁的分級徽章屬文件分級,並非回應欄位。