AI agent?先讀 /llms.txt 取得全站索引。
市場與價格
核心估值日線——每檔股票每交易日的核心估值比率(本益比、股價淨值比、殖利率)。
GET /v2/datasets/valuation-core-dailyvaluation-core-daily 為推導型資料集:結合官方日價格與每股盈餘、每股淨值及股利輸入,得出每檔股票每交易日的核心估值比率。lineage 欄位標明每個比率的計算來源,估值可稽核而非黑箱。
| 欄位 | 型別 | 說明 |
|---|---|---|
symbol | string | 股票代碼。 |
date | string | 交易日。 |
per | number | 本益比(推導)。 |
pbr | number | 股價淨值比(推導)。 |
dividend_yield | number | 殖利率(比值,推導)。 |
source_role | string | 正規來源角色(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。
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 | 回傳筆數上限。 |
第一個呼叫:
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)此端點為 GET /v2/datasets/valuation-core-daily。完整機器可讀 schema(參數、認證、回應封裝)見 OpenAPI spec。