AI agent？先讀 /llms.txt 取得全站索引。
財務與成長
增強月營收,已預先計算成長與滾動指標——在官方 MOPS 數字之上加上 YoY、MoM 與近十二個月(TTM)營收。
GET /v2/datasets/monthly-revenue-enhancedmonthly-revenue-enhanced 為推導型資料集:以官方 MOPS 月營收申報為基礎,附上原本需自行計算的成長率與近十二個月營收。lineage 欄位回指底層 MOPS 表單,基準數字可稽核。
| 欄位 | 型別 | 說明 |
|---|---|---|
symbol | string | 股票代碼。 |
period | string | 申報月份(YYYY-MM)。 |
revenue | number | MOPS 月營收(新台幣仟元)。 |
yoy | number | 營收年增率(比值)。 |
mom | number | 營收月增率(比值)。 |
ttm_revenue | number | 近十二個月營收(新台幣仟元)。 |
source_role | string | 正規來源角色(derived_mops_monthly_revenue_enhanced)。 |
| 列數 | 331,109 |
| 涵蓋起訖 | 2010-02-10 至 2026-07-10 |
| 分級 | 衍生 |
此為本端點的真實回應。資料列位於 "envelope.data" 之下，來源資訊如下方所示；各資料集形狀不盡相同，請以本頁為準。
{ "api_version": "v2", "endpoint": "/v2/datasets/monthly-revenue-enhanced", "request_id": "req_3b0e0cee6363", "plan_id": "enterprise", "dataset": "monthly_revenue_enhanced", "query": { "ticker": "2330", "period_from": null, "period_to": null, "limit": 50, "offset": 0, "sort_by": "period", "sort_order": "desc" }, "meta": { "rows_returned": 50, "mandatory_contract_fields_present": [ "api_version", "data", "data_as_of" ], "plan": "enterprise", "row_limit": 100000, "is_limited": false }, "envelope": { "api_version": "v2", "dataset": "monthly_revenue_enhanced", "dataset_version": "v2.0.0-preview", "release_version": "v2.2026-06-10.preview", "release_date": "2026-06-10", "data_as_of": "2026-06-10", "request_context": { "ticker": "2330", "as_of_date": "2026-06-10", "family": "fundamentals", "field_group_type": "derived", "dataset_view": "monthly_revenue_enhanced_v1", "supported_sort_by": [ "period" ], "supported_filter_fields": [ "ticker", "period_from", "period_to" ] }, "data": [ { "ticker": "2330", "market": "TWSE", "period": "2026-05", "as_of_date": "2026-06-10", "revenue": 416975163, "revenue_yoy_pct": 30.095, "revenue_mom_pct": 1.5217, "revenue_rolling_3m": 1242891980, "revenue_rolling_12m": 4261521438, "revenue_ytd": 1961803721, "revenue_ytd_yoy_pct": 29.9779, "provider": "twse_official", "source_role": "official_mops_monthly_revenue", "lineage": { "row_index": 279, "source_hash": "", "payload_date": "2026-05-01", "request_date": "2026-05-01", "endpoint_name": "t187ap05", "source_authority": "MOPS t187ap05" }, "updated_at": "2026-07-14T02:21:44.473057" }, { "ticker": "2330", "market": "TWSE", "period": "2026-04", "as_of_date": "2026-05-10", "revenue": 410725118, "revenue_yoy_pct": 17.495412, "revenue_mom_pct": -1.075788, "revenue_rolling_3m": 1143573430, "revenue_rolling_12m": 4165062226, "revenue_ytd": 1544828558, "revenue_ytd_yoy_pct": 29.946314, "provider": "mops_official", "source_role": "canonical", "lineage": { "revision_key": null, "source_table": "p0_canonical_fundamentals_daily", "normalization": "monthly_revenue_v1", "announcement_date": "2026-05-17", "source_publish_date": "2026-05-17", "transformation_version": "monthly_revenue_enhanced_v1" }, "updated_at": "2026-07-14T02:21:47.017593" } ], "quality": { "freshness_state": "fresh", "freshness_as_of": "2026-06-10", "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", "monthly_revenue_enhanced derived from canonical fundamentals monthly rows", "unstable fields excluded from public contract (surprise/score/seasonality-adjusted/custom)" ] }, "error": { "error_code": null, "error_message": null, "dataset": "monthly_revenue_enhanced", "request_id": "read-api-f27c556ebe6b", "blocking_gate": null } }}擷取自 2026-07-20 的線上 API。
curl "https://api.twmarketdata.com/v2/datasets/monthly-revenue-enhanced?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/monthly-revenue-enhanced", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json()["envelope"]["data"])帶日期區間篩選：
import requests # The full verified example — the same call with every supported filter set.resp = requests.get( "https://api.twmarketdata.com/v2/datasets/monthly-revenue-enhanced", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()for row in resp.json()["envelope"]["data"]: print(row)此端點為 GET /v2/datasets/monthly-revenue-enhanced。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。