Building an AI agent? Start with /llms.txt for the full site index.
Financials & Growth
Quarterly balance sheets for listed companies, sourced from MOPS — total assets, liabilities and equity as filed.
GET /v2/datasets/balance-sheetbalance-sheet returns one row per company per fiscal period from the official MOPS filings. The lineage block names the exact MOPS form the figures came from, so the balance is traceable to its source statement.
| Field | Type | Description |
|---|---|---|
symbol | string | Ticker. |
period | string | Fiscal period (e.g. 2026-Q1). |
total_assets | number | Total assets (TWD thousands). |
total_liabilities | number | Total liabilities (TWD thousands). |
total_equity | number | Total equity (TWD thousands). |
source_role | string | Canonical source role (official_mops_balance_sheet). |
| Rows | 103,577 |
| Window | 2013-03-31 – 2026-03-31 |
| Grade | Verified |
A real response from this endpoint. Rows are returned under "rows", and provenance is carried in the shape shown below — it is not identical across datasets, so read this page's rather than assuming another's.
{ "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": "<Chinese value - see the zh page>", "verified": true }, "total_liabilities": { "currency": "TWD", "scale": "thousand_twd", "scale_multiplier": 1000, "unit_label": "<Chinese value - see the zh page>", "verified": true }, "total_equity": { "currency": "TWD", "scale": "thousand_twd", "scale_multiplier": 1000, "unit_label": "<Chinese value - see the zh page>", "verified": true }, "cash_and_cash_equivalents": { "currency": "TWD", "scale": "thousand_twd", "scale_multiplier": 1000, "unit_label": "<Chinese value - see the zh page>", "verified": true }, "accounts_receivable": { "currency": "TWD", "scale": "thousand_twd", "scale_multiplier": 1000, "unit_label": "<Chinese value - see the zh page>", "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": "<Chinese value - see the zh page>" }, "meta": { "plan": "enterprise", "row_limit": 100000, "is_limited": false }}Captured from the live API on 2026-07-20.
Chinese data values are shown as a marker here so this page stays in English; the /zh page shows them verbatim.
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_..."| Parameter | Required | Type | Description |
|---|---|---|---|
symbol | Yes | string | Ticker, e.g. 2330. |
start_date | No | string (YYYY-MM-DD) | Start of the query range. |
end_date | No | string (YYYY-MM-DD) | End of the query range. |
limit | No | integer | Maximum rows to return. |
A first call:
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"])With a date-range filter:
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)This endpoint is GET /v2/datasets/balance-sheet. The full machine-readable schema (parameters, security, response envelope) lives in the OpenAPI spec.