財務與分析
財報（資產負債表）
提供公司資產負債表關鍵欄位，適合用於資本結構、償債能力與財務穩健度分析。
GET
/v2/datasets/balance-sheetOverview#
此資料集為「財報資料」的一部分，建議搭配損益表與現金流量表一起使用。
資產負債表 API 提供公司資產、負債與權益欄位，適合用於資本結構與償債能力分析。
資料來自公開揭露來源，並以結構化欄位回傳。
- 觀察公司資本結構與資產負債變化。
- 搭配損益表與現金流量表評估財務穩健度。
- 建立財務健康度與風險監控指標。
- 在研究流程中做跨期比較分析。
Request#
使用此 endpoint 時，建議：
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 / 使用建議#
- 財報資料互補：建議搭配損益表 `/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`。
Plan Requirement#
- Free（限制）
- Developer
- Pro
- Enterprise