Building an AI agent? Start with /llms.txt for the full site index.

財務與分析

財報（資產負債表）

提供公司資產負債表關鍵欄位，適合用於資本結構、償債能力與財務穩健度分析。

This documentation page is currently available in Chinese only; English versions are coming soon.

GET/v2/datasets/balance-sheet

Overview

此資料集為「財報資料」的一部分，建議搭配損益表與現金流量表一起使用。

資產負債表 API 提供公司資產、負債與權益欄位，適合用於資本結構與償債能力分析。

資料來自公開揭露來源，並以結構化欄位回傳；本次為文件同步更新，不涉及 API 行為變更。

觀察公司資本結構與資產負債變化。
搭配損益表與現金流量表評估財務穩健度。
建立財務健康度與風險監控指標。
在研究流程中做跨期比較分析。

Coverage

Instruments	Start year	Update timing	Includes delisted
Not yet available (coming)	Not yet available (coming)	Not yet available (coming)	coming

Figures are measured from the DB; unlisted fields defer to docs coverage (coming) — we don't fabricate cell by cell.

Query Parameters

欄位	型別	Required	說明
symbol	string	yes	股票代碼（內部對應 ticker）。
start_date	string	no	查詢起始日期（YYYY-MM-DD）。
end_date	string	no	查詢結束日期（YYYY-MM-DD）。
limit	integer	no	回傳筆數（預設 100，最大 5000）。

Response Shape

回應結構固定為 dataset、rows、count，並附 meta（plan/row_limit/is_limited）。

{  "dataset": "balance_sheet",  "rows": [    {      "symbol": "2330",      "fiscal_year": 2025,      "fiscal_quarter": 4,      "period_type": "quarterly",      "period_end_date": "2025-12-31",      "report_date": "2026-03-08",      "source": "mops_official",      "total_assets": 7120000000000,      "total_liabilities": 2920000000000,      "total_equity": 4200000000000,      "cash_and_cash_equivalents": 1980000000000,      "inventory": 294000000000,      "accounts_receivable": 362000000000,      "updated_at": "2026-04-23T03:10:00+00:00"    }  ],  "count": 1,  "meta": {    "plan": "free",    "row_limit": 50,    "is_limited": false  }}

Field 說明

欄位路徑	型別	說明
rows[].symbol	string	股票代碼。
rows[].fiscal_year	integer	財政年度。
rows[].fiscal_quarter	integer\|null	財政季度。
rows[].period_type	string	期間類型（quarterly/annual/ttm）。
rows[].period_end_date	string	財報期間結束日期。
rows[].report_date	string\|null	公告或報告日期。
rows[].source	string	來源識別。
rows[].total_assets	number\|null	總資產。
rows[].total_liabilities	number\|null	總負債。
rows[].total_equity	number\|null	股東權益總額。
rows[].cash_and_cash_equivalents	number\|null	現金及約當現金。
rows[].inventory	number\|null	存貨。
rows[].accounts_receivable	number\|null	應收帳款。
rows[].updated_at	string\|null	資料更新時間。
count	integer	回傳資料筆數。
meta.plan	string	目前方案代碼。
meta.row_limit	integer	方案每次請求可回傳上限。
meta.is_limited	boolean	是否因方案限制而截斷資料。

Usage Notes / 使用建議

Baseline freeze signoff 已通過（balance_sheet）：驗證視窗為 2023-06-30..2026-03-31。
來源與主表：mops_official 與 official_mopsov_ajax_t163sb05，source-of-truth table 為 `fundamental_balance_sheets`。
覆蓋統計：duplicate logical keys=0；實際覆蓋筆數與涵蓋股票數詳見 /datasets。
資料治理：raw_payload 非空筆數=0（不保留 raw payload）。
冪等性證據：would_insert=0、would_update=0（high confidence）。
財報資料互補：建議搭配損益表 `/v2/datasets/income-statement` 與現金流量表 `/v2/datasets/cash-flow-statement`。
欄位完整度會因公司與期間不同而有差異，缺值應以 null 處理。
日期欄位以 Asia/Taipei 財報語意（YYYY-MM-DD）為準。
Canonical 補充：`/v2/datasets/financials` 為較低層查詢面，支援 statement_type/period_type。
一般產品整合建議優先使用本頁主公開 endpoint `/v2/datasets/balance-sheet`。
限制聲明：本頁不宣稱即時資料（real-time）、不構成投資建議，且不額外主張 TPEx/OTC 完整覆蓋。
範圍聲明：本頁僅陳述已驗證期間與統計，不主張超出 2023-06-30..2026-03-31 的完整歷史覆蓋。

Limitations & notes

Coverage is not the full market or full history; the actual range is defined by the coverage table above and the data_gaps in the response.
Missing data is flagged honestly — we don't fill gaps with estimated values.
The platform focuses on daily-frequency and fundamental data; it does not provide real-time quotes, intraday bars, or cryptocurrencies.
TWSE is the verified baseline; TPEx history depth and adjusted prices are currently beta / deferred, flagged per dataset.

Plan Requirement

Free（限制）
Developer
Pro
Enterprise

此 API 屬於 TW Market Data 資料集目錄。查看資料集總覽

請求與回應

Request example

curl --request GET \  --url "https://api.twmarketdata.com/v2/datasets/balance-sheet?symbol=2330&start_date=2025-01-01&end_date=2026-12-31&limit=12" \  --header "X-API-Key: your_api_key_here"

Status codes

成功回傳資產負債表資料

JSON

{  "dataset": "balance_sheet",  "rows": [    {      "symbol": "2330",      "fiscal_year": 2025,      "fiscal_quarter": 4,      "period_type": "quarterly",      "period_end_date": "2025-12-31",      "report_date": "2026-03-08",      "source": "mops_official",      "total_assets": 7120000000000,      "total_liabilities": 2920000000000,      "total_equity": 4200000000000,      "cash_and_cash_equivalents": 1980000000000,      "inventory": 294000000000,      "accounts_receivable": 362000000000,      "updated_at": "2026-04-23T03:10:00+00:00"    }  ],  "count": 1,  "meta": {    "plan": "free",    "row_limit": 50,    "is_limited": false  }}

Overview

此資料集為「財報資料」的一部分，建議搭配損益表與現金流量表一起使用。

資產負債表 API 提供公司資產、負債與權益欄位，適合用於資本結構與償債能力分析。

資料來自公開揭露來源，並以結構化欄位回傳；本次為文件同步更新，不涉及 API 行為變更。

觀察公司資本結構與資產負債變化。

搭配損益表與現金流量表評估財務穩健度。

建立財務健康度與風險監控指標。

在研究流程中做跨期比較分析。

Instruments

Start year

Update timing

Includes delisted

Not yet available (coming)

coming

欄位

型別

Required

說明

symbol

string

yes

股票代碼（內部對應 ticker）。

start_date

string

查詢起始日期（YYYY-MM-DD）。

end_date

string

查詢結束日期（YYYY-MM-DD）。

limit

integer

回傳筆數（預設 100，最大 5000）。

Response Shape

回應結構固定為 dataset、rows、count，並附 meta（plan/row_limit/is_limited）。

{  "dataset": "balance_sheet",  "rows": [    {      "symbol": "2330",      "fiscal_year": 2025,      "fiscal_quarter": 4,      "period_type": "quarterly",      "period_end_date": "2025-12-31",      "report_date": "2026-03-08",      "source": "mops_official",      "total_assets": 7120000000000,      "total_liabilities": 2920000000000,      "total_equity": 4200000000000,      "cash_and_cash_equivalents": 1980000000000,      "inventory": 294000000000,      "accounts_receivable": 362000000000,      "updated_at": "2026-04-23T03:10:00+00:00"    }  ],  "count": 1,  "meta": {    "plan": "free",    "row_limit": 50,    "is_limited": false  }}

Field 說明

欄位路徑	型別	說明
rows[].symbol	string	股票代碼。
rows[].fiscal_year	integer	財政年度。
rows[].fiscal_quarter	integer\|null	財政季度。
rows[].period_type	string	期間類型（quarterly/annual/ttm）。
rows[].period_end_date	string	財報期間結束日期。
rows[].report_date	string\|null	公告或報告日期。
rows[].source	string	來源識別。
rows[].total_assets	number\|null	總資產。
rows[].total_liabilities	number\|null	總負債。
rows[].total_equity	number\|null	股東權益總額。
rows[].cash_and_cash_equivalents	number\|null	現金及約當現金。
rows[].inventory	number\|null	存貨。
rows[].accounts_receivable	number\|null	應收帳款。
rows[].updated_at	string\|null	資料更新時間。
count	integer	回傳資料筆數。
meta.plan	string	目前方案代碼。
meta.row_limit	integer	方案每次請求可回傳上限。
meta.is_limited	boolean	是否因方案限制而截斷資料。

Usage Notes / 使用建議

Baseline freeze signoff 已通過（balance_sheet）：驗證視窗為 2023-06-30..2026-03-31。

來源與主表：mops_official 與 official_mopsov_ajax_t163sb05，source-of-truth table 為 `fundamental_balance_sheets`。

覆蓋統計：duplicate logical keys=0；實際覆蓋筆數與涵蓋股票數詳見 /datasets。

資料治理：raw_payload 非空筆數=0（不保留 raw payload）。

冪等性證據：would_insert=0、would_update=0（high confidence）。

財報資料互補：建議搭配損益表 `/v2/datasets/income-statement` 與現金流量表 `/v2/datasets/cash-flow-statement`。

欄位完整度會因公司與期間不同而有差異，缺值應以 null 處理。

日期欄位以 Asia/Taipei 財報語意（YYYY-MM-DD）為準。

Canonical 補充：`/v2/datasets/financials` 為較低層查詢面，支援 statement_type/period_type。

一般產品整合建議優先使用本頁主公開 endpoint `/v2/datasets/balance-sheet`。

限制聲明：本頁不宣稱即時資料（real-time）、不構成投資建議，且不額外主張 TPEx/OTC 完整覆蓋。

範圍聲明：本頁僅陳述已驗證期間與統計，不主張超出 2023-06-30..2026-03-31 的完整歷史覆蓋。

Limitations & notes

Coverage is not the full market or full history; the actual range is defined by the coverage table above and the data_gaps in the response.

Missing data is flagged honestly — we don't fill gaps with estimated values.

The platform focuses on daily-frequency and fundamental data; it does not provide real-time quotes, intraday bars, or cryptocurrencies.

TWSE is the verified baseline; TPEx history depth and adjusted prices are currently beta / deferred, flagged per dataset.

{ "dataset": "balance_sheet", "rows": [ { "symbol": "2330", "fiscal_year": 2025, "fiscal_quarter": 4, "period_type": "quarterly", "period_end_date": "2025-12-31", "report_date": "2026-03-08", "source": "mops_official", "total_assets": 7120000000000, "total_liabilities": 2920000000000, "total_equity": 4200000000000, "cash_and_cash_equivalents": 1980000000000, "inventory": 294000000000, "accounts_receivable": 362000000000, "updated_at": "2026-04-23T03:10:00+00:00" } ], "count": 1, "meta": { "plan": "free", "row_limit": 50, "is_limited": false }}