TW Market Data LogoTW Market Data

Facts & statistics

Market facts

Long-run statistics for Taiwan equities, each with its sample period and as_of

Seasonality

Monthly return distributions and hit rates, with sample sizes

Institutional flow

Seasonality in the breadth of institutional net buying

Limit events

How often limit moves happen, and how concentrated they are

Delisting

Delisting counts and survival spans — the basis for avoiding survivorship bias

Rule changes

A timeline of trading-rule changes — the premise for reading historical data

Data & exploration

Dataset catalogue

Every dataset, its coverage, and how often it updates

Playground

Call the API from the browser, without a key

Market today

Today's market at a glance

Stock analysis

The entry point for looking at one instrument

Market heat map

The whole market in one picture — area is market cap, colour is revenue growth

Market calendar

Statutory disclosure deadlines — the day a figure may legally first be known

Platform capabilities

Product overview

What TWMD provides, and who it is built for

Verifiable proof

Signed checkpoints and per-row inclusion proofs

Data quality

Reconciliation, gap handling, and quality status

Methodology

How the figures are computed, and on what basis

Auditable execution

Tie a trading decision back to the data it saw

Connect your broker

Bring TWMD into an existing order and research workflow

Developers

Documentation

API reference, dataset pages, and integration guides

Quick start

Authentication and your first request

Integrate by role

Separate paths for quant research, data engineering, and app development

Connect over MCP

Point an agent straight at TWMD

MCP registry

The published MCP tool list and its signed manifest

Webhooks

Have your system told when data updates

Learn

Blog

Long-form writing on data, method, and market structure

Answers

Specific answers to specific questions, with sources

Topics

Industry chains and thematic relationships

Help centre

Account, billing, and usage questions

Glossary

Definitions for Taiwan-market and data terms

Compare & status

Why TWMD

A point-by-point comparison with FinMind and TEJ

Migrate from FinMind

Field mapping and migration steps

Migrate from FinLab

Field mapping and migration steps

Migrate from TEJ

Field mapping and migration steps

Status

Service availability and incident history

Security & trust

Trust centre

What we claim, and the limits on each claim

Security

Architecture, access control, and incident handling

Security facts

The items you can verify from outside

Security evidence

SBOM, ASVS mapping and threat model — including the three controls we do not meet.

Self-assessment

Item-by-item answers for a procurement questionnaire

Compliance & standards

Compliance mapping

Evidence primitives mapped onto FSB, IOSCO, and SR 26-2

Standards & interop

Term-by-term mapping onto published standards, and where it does not map

Provenance & C2PA

A machine-readable origin graph, fetchable without a key

Licensing

How the data may be used and redistributed

Adoption

Evaluate

Seven checks you can run yourself, without an account

Talk to sales

Enterprise plans, quotas, and contract detail

Pricing
中文Sign inSign up
TW Market Data

Taiwan market-data infrastructure, built for AI agents and quantitative workflows.

Status unknown
© 2026 TW Market Data

TW Market Data (TWMD) provides historical data and statistics, not investment advice; investment decisions and their risks are your own.

  • Privacy Policy·
  • Terms of Service·
  • Cookie Policy·
  • Acceptable Use Policy·
  • Data Sources & Licensing·
  • Legal (all documents)
中文

AI Agent

  • MCP Server
  • Skills
  • Tool manifest
  • Agent workflow examples
  • Agent benchmark
  • llms.txt
  • OpenAPI spec

Security

  • Security overview
  • Verifiable data
  • Trust Center
  • Standards & Interop
  • Regulatory mapping

Product

  • Datasets
  • Topics
  • Market facts
  • Documentation
  • Integration runbooks
  • Playground (no signup)
  • Free tier
  • Solutions

Company

  • About TWMD
  • Blog
  • Help centre
  • Pricing

Documentation

DASHBOARD

DashboardPricing

FOR AI AGENTS

MCP ServerSkillsllms.txtTool manifestOpenAPI SpecAgent workflow examples

OVERVIEW

OverviewQuick startAuthenticationSource policyData gradesData lineageMarket coverage

DATA APIS

GUIDES

How to get the 3 financial statementsHow to read institutional flowsHow to check market statusHow to wire a strategy / AI agent

SDKS

Release statusPython SDKJavaScript / TypeScript SDK

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

InstrumentsStart yearUpdate timingIncludes 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.

Request

使用此 endpoint 時,建議:

Query Parameters

欄位型別Required說明
symbolstringyes股票代碼(內部對應 ticker)。
start_datestringno查詢起始日期(YYYY-MM-DD)。
end_datestringno查詢結束日期(YYYY-MM-DD)。
limitintegerno回傳筆數(預設 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[].symbolstring股票代碼。
rows[].fiscal_yearinteger財政年度。
rows[].fiscal_quarterinteger|null財政季度。
rows[].period_typestring期間類型(quarterly/annual/ttm)。
rows[].period_end_datestring財報期間結束日期。
rows[].report_datestring|null公告或報告日期。
rows[].sourcestring來源識別。
rows[].total_assetsnumber|null總資產。
rows[].total_liabilitiesnumber|null總負債。
rows[].total_equitynumber|null股東權益總額。
rows[].cash_and_cash_equivalentsnumber|null現金及約當現金。
rows[].inventorynumber|null存貨。
rows[].accounts_receivablenumber|null應收帳款。
rows[].updated_atstring|null資料更新時間。
countinteger回傳資料筆數。
meta.planstring目前方案代碼。
meta.row_limitinteger方案每次請求可回傳上限。
meta.is_limitedboolean是否因方案限制而截斷資料。

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.
  • Queries do not support an as_of parameter (roadmap). For point-in-time, filter on each row's knowledge_date, which is set conservatively to the statutory filing deadline. Daily prices do not carry that column.

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  }}