AI agent？先讀 /llms.txt 取得全站索引。
財務與成長
上市櫃公司季度資產負債表,來源為公開資訊觀測站(MOPS)——申報之資產、負債與權益總額。
GET /v2/datasets/balance-sheetbalance-sheet 以官方 MOPS 申報為源,每家公司每個會計期間回傳一列;lineage 欄位標明數字來自哪一份 MOPS 表單,結構可回溯原始報表。
| 欄位 | 型別 | 說明 |
|---|---|---|
symbol | string | 股票代碼。 |
period | string | 會計期間(如 2026-Q1)。 |
total_assets | number | 資產總額(新台幣仟元)。 |
total_liabilities | number | 負債總額(新台幣仟元)。 |
total_equity | number | 權益總額(新台幣仟元)。 |
source_role | string | 正規來源角色(official_mops_balance_sheet)。 |
| 列數 | 103,577 |
| 涵蓋起訖 | 2013-03-31 至 2026-03-31 |
| 分級 | 已驗證 |
此為本端點的真實回應。資料列位於 "rows" 之下，來源資訊如下方所示；各資料集形狀不盡相同，請以本頁為準。
{ "dataset": "balance_sheet", "rows": [ { "symbol": "2330", "ticker": "2330", "fiscal_year": 2026, "fiscal_quarter": 1, "period_type": "quarterly", "period_end_date": "2026-03-31", "report_date": "2026-03-31", "total_assets": 8660949685, "total_liabilities": 2728560764, "total_equity": 5932388921, "cash_and_cash_equivalents": null, "inventory": null, "accounts_receivable": null, "current_assets": null, "current_liabilities": null, "source": "mops_official", "source_name": "mops_official", "fiscal_period": "2026-Q1", "frequency": "quarterly", "created_at": "2026-05-17T17:12:58.659044", "updated_at": "2026-05-17T17:12:58.659044", "fundamentals_context": { "generated_at": "2026-07-20T18:31:54Z", "ticker": "2330", "period": "2026Q1", "period_type": "quarterly", "statement_family": "balance_sheet", "metric_values": { "symbol": "2330", "period_end_date": "2026-03-31", "report_date": "2026-03-31", "total_assets": 8660949685, "total_liabilities": 2728560764, "total_equity": 5932388921, "cash_and_cash_equivalents": null, "inventory": null, "accounts_receivable": null, "current_assets": null, "current_liabilities": null, "source": "mops_official", "source_name": "mops_official", "fiscal_period": "2026-Q1", "frequency": "quarterly", "created_at": "2026-05-17T17:12:58.659044", "updated_at": "2026-05-17T17:12:58.659044" }, "source_lineage": { "provider": "mops_official", "source_role": "official_mops_balance_sheet", "source_table": "fundamental_balance_sheets", "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": "balance_sheet", "path": "/v2/datasets/balance-sheet" }, { "name": "balance_sheet", "path": "/v2/datasets/financials" } ] } }, { "symbol": "2330", "ticker": "2330", "fiscal_year": 2026, "fiscal_quarter": 1, "period_type": "quarterly", "period_end_date": "2026-03-31", "report_date": "2026-05-15", "total_assets": 8660949685, "total_liabilities": 2728560764, "total_equity": 5932388921, "cash_and_cash_equivalents": null, "inventory": null, "accounts_receivable": null, "current_assets": null, "current_liabilities": null, "source": "mops_t163sb05", "source_name": "mops_t163sb05", "fiscal_period": "2026-Q1", "frequency": "quarterly", "created_at": "2026-07-04T18:13:02.632865", "updated_at": "2026-07-04T18:13:02.632865", "fundamentals_context": { "generated_at": "2026-07-20T18:31:54Z", "ticker": "2330", "period": "2026Q1", "period_type": "quarterly", "statement_family": "balance_sheet", "metric_values": { "symbol": "2330", "period_end_date": "2026-03-31", "report_date": "2026-05-15", "total_assets": 8660949685, "total_liabilities": 2728560764, "total_equity": 5932388921, "cash_and_cash_equivalents": null, "inventory": null, "accounts_receivable": null, "current_assets": null, "current_liabilities": null, "source": "mops_t163sb05", "source_name": "mops_t163sb05", "fiscal_period": "2026-Q1", "frequency": "quarterly", "created_at": "2026-07-04T18:13:02.632865", "updated_at": "2026-07-04T18:13:02.632865" }, "source_lineage": { "provider": "mops_t163sb05", "source_role": "official_mops_balance_sheet", "source_table": "fundamental_balance_sheets", "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": "balance_sheet", "path": "/v2/datasets/balance-sheet" }, { "name": "balance_sheet", "path": "/v2/datasets/financials" } ] } } ], "count": 50, "plan_id": "enterprise", "status": "ok", "unit": { "currency": "TWD", "scale": "per_field", "fields": { "total_assets": { "currency": "TWD", "scale": "thousand_twd", "scale_multiplier": 1000, "unit_label": "仟元", "verified": true }, "total_liabilities": { "currency": "TWD", "scale": "thousand_twd", "scale_multiplier": 1000, "unit_label": "仟元", "verified": true }, "total_equity": { "currency": "TWD", "scale": "thousand_twd", "scale_multiplier": 1000, "unit_label": "仟元", "verified": true }, "cash_and_cash_equivalents": { "currency": "TWD", "scale": "thousand_twd", "scale_multiplier": 1000, "unit_label": "仟元", "verified": true }, "accounts_receivable": { "currency": "TWD", "scale": "thousand_twd", "scale_multiplier": 1000, "unit_label": "仟元", "verified": true }, "inventory": { "currency": "TWD", "scale": "scale_unknown", "scale_multiplier": null, "unit_label": null, "verified": false, "reason": "no populated value exists to verify a scale against; the unit is NOT asserted" } }, "unverified_fields": [ "inventory" ], "source_of_truth": "official_mops_statement", "note": "科目字典(§2b):單位以官方 MOPS 報表為準——三大報表金額為仟元(值 ×1000 = 元),EPS 為元/股,比率為 %。每個科目的 scale 皆以官方公布數字核對過;無法核對者標 scale_unknown,不臆測。" }, "meta": { "plan": "enterprise", "row_limit": 100000, "is_limited": false }}擷取自 2026-07-20 的線上 API。
本頁顯示原始中文值；英文頁會以標記取代，以維持全英文。
curl "https://api.twmarketdata.com/v2/datasets/balance-sheet?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/balance-sheet", 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/balance-sheet", 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/balance-sheet。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。