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

股利政策月營收資產負債表現金流量表損益表財務比率指標財報三表合併增強月營收

GUIDES

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

SDKS

Release StatusPython SDKJavaScript / TypeScript SDK

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

財務與成長

損益表

上市櫃公司季度損益表,來源為公開資訊觀測站(MOPS)——自營收到營業利益、稅後淨利與每股盈餘。

已驗證來源: MOPS·方案: pro·計費: 2 點·GET /v2/datasets/income-statement

總覽

income-statement 以官方 MOPS 財報申報為源,每家公司每個會計期間回傳一列;每列附來源角色與 lineage 標明所屬 MOPS 表單,任一數字可回溯申報稿而非黑箱。

欄位型別說明
symbolstring股票代碼。
periodstring會計期間(如 2026-Q1)。
revenuenumber營業收入淨額(新台幣仟元)。
operating_incomenumber營業利益(新台幣仟元)。
net_incomenumber歸屬母公司稅後淨利(新台幣仟元)。
epsnumber基本每股盈餘(新台幣元)。
source_rolestring正規來源角色(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。

本頁顯示原始中文值;英文頁會以標記取代,以維持全英文。

快速開始

  1. 把你的金鑰放進 X-API-Key 標頭。
  2. 加上查詢參數(symbol、日期區間、limit)。
  3. 送出請求並讀取 rows 陣列。
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回傳筆數上限。

Python 範例

第一個呼叫:

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)

OpenAPI

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

備註與限制

  • 申報財報具時間點敏感性且會重編:回測時請帶 as_of,只會看到當下已公開的數字。

請求與回應

請求

curl "https://api.twmarketdata.com/v2/datasets/income-statement?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
{  "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,不臆測。"  }}

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

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

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