AI agent?先讀 /llms.txt 取得全站索引。
財務與成長
上市櫃公司季度損益表,來源為公開資訊觀測站(MOPS)——自營收到營業利益、稅後淨利與每股盈餘。
GET /v2/datasets/income-statementincome-statement 以官方 MOPS 財報申報為源,每家公司每個會計期間回傳一列;每列附來源角色與 lineage 標明所屬 MOPS 表單,任一數字可回溯申報稿而非黑箱。
| 欄位 | 型別 | 說明 |
|---|---|---|
symbol | string | 股票代碼。 |
period | string | 會計期間(如 2026-Q1)。 |
revenue | number | 營業收入淨額(新台幣仟元)。 |
operating_income | number | 營業利益(新台幣仟元)。 |
net_income | number | 歸屬母公司稅後淨利(新台幣仟元)。 |
eps | number | 基本每股盈餘(新台幣元)。 |
source_role | string | 正規來源角色(official_mops_income_statement)。 |
| 列數 | 90,713 |
| 涵蓋起訖 | 2013-03-31 至 2026-03-31 |
| 分級 | 已驗證 |
此為本端點的真實回應。資料列位於 "rows" 之下,來源資訊如下方所示;各資料集形狀不盡相同,請以本頁為準。
{ "dataset": "income_statement", "rows": [ { "fiscal_year": 2026, "fiscal_quarter": 1, "period_type": "quarterly", "period_end_date": "2026-03-31", "report_date": null, "source": "mops_official", "revenue": 1134103440, "gross_profit": 751295421, "operating_income": 658966142, "pretax_income": 687799687, "net_income": 572801304, "eps": 22.08, "updated_at": "2026-06-04T06:44:59.737553", "symbol": "2330", "fiscal_period": "2026-Q1", "frequency": "quarterly", "fundamentals_context": { "generated_at": "2026-07-20T18:31:56Z", "ticker": "2330", "period": "2026Q1", "period_type": "quarterly", "statement_family": "income_statement", "metric_values": { "period_end_date": "2026-03-31", "report_date": null, "source": "mops_official", "revenue": 1134103440, "gross_profit": 751295421, "operating_income": 658966142, "pretax_income": 687799687, "net_income": 572801304, "eps": 22.08, "updated_at": "2026-06-04T06:44:59.737553", "symbol": "2330", "fiscal_period": "2026-Q1", "frequency": "quarterly" }, "source_lineage": { "provider": "mops_official", "source_role": "official_mops_income_statement", "source_table": "fundamental_income_statements", "ingestion_run_id": null, "transformation_version": "fundamentals_ai_context_v1" }, "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": "income_statement", "path": "/v2/datasets/income-statement" }, { "name": "income_statement", "path": "/v2/datasets/financials" } ] } }, { "fiscal_year": 2025, "fiscal_quarter": 4, "period_type": "quarterly", "period_end_date": "2025-12-31", "report_date": null, "source": "mops_official", "revenue": 3809054272, "gross_profit": 2281293979, "operating_income": 1936091677, "pretax_income": 2041662840, "net_income": 1715396780, "eps": 66.26, "updated_at": "2026-06-04T06:44:59.737553", "symbol": "2330", "fiscal_period": "2025-Q4", "frequency": "quarterly", "fundamentals_context": { "generated_at": "2026-07-20T18:31:56Z", "ticker": "2330", "period": "2025Q4", "period_type": "quarterly", "statement_family": "income_statement", "metric_values": { "period_end_date": "2025-12-31", "report_date": null, "source": "mops_official", "revenue": 3809054272, "gross_profit": 2281293979, "operating_income": 1936091677, "pretax_income": 2041662840, "net_income": 1715396780, "eps": 66.26, "updated_at": "2026-06-04T06:44:59.737553", "symbol": "2330", "fiscal_period": "2025-Q4", "frequency": "quarterly" }, "source_lineage": { "provider": "mops_official", "source_role": "official_mops_income_statement", "source_table": "fundamental_income_statements", "ingestion_run_id": null, "transformation_version": "fundamentals_ai_context_v1" }, "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": "income_statement", "path": "/v2/datasets/income-statement" }, { "name": "income_statement", "path": "/v2/datasets/financials" } ] } } ], "count": 50, "status": "ok", "data_as_of": null, "pit": false, "unit": { "currency": "TWD", "scale": "per_field", "fields": { "revenue": { "currency": "TWD", "scale": "thousand_twd", "scale_multiplier": 1000, "unit_label": "仟元", "verified": true }, "gross_profit": { "currency": "TWD", "scale": "thousand_twd", "scale_multiplier": 1000, "unit_label": "仟元", "verified": true }, "operating_income": { "currency": "TWD", "scale": "thousand_twd", "scale_multiplier": 1000, "unit_label": "仟元", "verified": true }, "pretax_income": { "currency": "TWD", "scale": "thousand_twd", "scale_multiplier": 1000, "unit_label": "仟元", "verified": true }, "net_income": { "currency": "TWD", "scale": "thousand_twd", "scale_multiplier": 1000, "unit_label": "仟元", "verified": true }, "eps": { "currency": "TWD", "scale": "twd_per_share", "scale_multiplier": 1, "unit_label": "元/股", "verified": true } }, "unverified_fields": [], "source_of_truth": "official_mops_statement", "note": "科目字典(§2b):單位以官方 MOPS 報表為準——三大報表金額為仟元(值 ×1000 = 元),EPS 為元/股,比率為 %。每個科目的 scale 皆以官方公布數字核對過;無法核對者標 scale_unknown,不臆測。" }}擷取自 2026-07-20 的線上 API。
本頁顯示原始中文值;英文頁會以標記取代,以維持全英文。
curl "https://api.twmarketdata.com/v2/datasets/income-statement?symbol=2330&start_date=2026-06-01&end_date=2026-07-15&limit=5" \ -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/income-statement", params={"symbol": "2330", "limit": "5"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json()["rows"])帶日期區間篩選:
import requests # The full verified example — the same call with every supported filter set.resp = requests.get( "https://api.twmarketdata.com/v2/datasets/income-statement", params={"symbol": "2330", "start_date": "2026-06-01", "end_date": "2026-07-15", "limit": "5"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()for row in resp.json()["rows"]: print(row)此端點為 GET /v2/datasets/income-statement。完整機器可讀 schema(參數、認證、回應封裝)見 OpenAPI spec。