Skip to main content
Taiwan Financials provides quarterly financial statements for Taiwan-listed companies on TWSE and TPEx. Each observation is one statement for one fiscal season, in TWD thousands, as filed with the Taiwan exchanges. Coverage starts at 2013 Q1.
Plan: Free and above · Credits: 1 per call · MCP tool: get_taiwan_financials

​
What You Can Use Taiwan Financials For

Build a quarterly revenue and margin history for a Taiwan-listed company. Compare a quarter against the same quarter a year earlier. Pair the quarterly statements with Taiwan Monthly Revenue, which reports far sooner.

​
Taiwan Income Statements Are Filed Cumulatively

Read this before using any income figure. TWSE files income-statement values cumulative from the start of the fiscal year. Season 2 is the first half and season 4 is the full year.Reading a cumulative value as a quarter overstates Q4 by roughly the whole year.
Because of that, every income line comes back twice. The _ytd fields — revenue_ytd and its siblings — are the figure as filed, cumulative. The _q fields — revenue_q and its siblings — are the single quarter.

​
How to Read quarter_basis

quarter_basis says how the _q value was arrived at. as_reported means season 1, where the cumulative figure is already the quarter and no arithmetic was applied. derived_from_ytd means this season’s cumulative figure minus the previous season’s. null means the previous season is missing, in which case the _q fields are null. Those nulls must not be treated as zero.

​
Income Rows and Balance Rows Are Different Shapes

statement is income or balance. There is no cash-flow statement in this dataset: the summary tables it is built from print none, and no balance-sheet detail beyond total assets, total liabilities, total equity and share capital. Cash, inventories, PP&E, borrowings, net debt, capex, depreciation and free cash flow come from Taiwan Cash Flow instead. An empty answer here to a cash question means the wrong endpoint, not missing data. Balance-sheet rows are point-in-time: never cumulative and never derived. Their income columns are null, and income rows have null balance columns.

​
Line Items Come Back Only When You Ask

By default the rows carry the statement totals. Pass line_items=true to add the detail the filing also prints: cost of revenue, operating expenses, the tax line, the current and non-current split, the equity components, and the loan and deposit lines that banks file instead of a classified balance sheet. Most of these are null for any one industry. An empty cost of revenue without line_items=true is the flag, not missing data. Two line items need care:
  • gross_profit is struck after the intercompany elimination lines. Revenue less cost of revenue reaches gross_profit_before_elimination.
  • Banks and financial holdings filed the income tax line with the opposite sign before 2018. Read income_tax_basis rather than subtracting the tax line blindly.

​
Taiwan Financials Date Convention

year is the fiscal year and season is the TWSE season, 1 to 4. A season is a fiscal quarter, but because income is filed cumulatively, the season number describes the end of the cumulative window on the _ytd fields and the quarter itself on the _q fields.

​
Taiwan Financials Units

Amounts are TWD thousands. The response states currency and unit explicitly — read them rather than assuming a scale.
The per-share fields — eps_basic_ytd, eps_basic_q and book_value_per_share — are in plain TWD per share, not thousands. TSMC’s eps_basic_ytd of 49.33 is NT$49.33. Applying unit to every number overstates EPS a thousandfold.

​
The metrics Block

Next to the rows, the response carries a metrics object: derived figures for the company’s latest period, the same values Company Screening filters and sorts on.
  • period and grain say which period the block describes. It does not follow the year or season you asked for.
  • amounts are in whole TWD, with unit of ones — a different scale from the rows beside them, which are in thousands.
  • ratios are fractions, so 0.2 means 20%, except days_sales_outstanding and operating_cycle, which are days.
  • growth holds year-on-year growth rates, also as fractions, and flags holds is_lossmaking and equity_negative.
A null field in the block means the source does not publish what it needs, not zero: Taiwan publishes no receivables balance and no interest expense, so the fields built on them are null for every Taiwan company. metrics itself is null when no fundamentals are held for the company.

​
Taiwan Financials Sources

Statements are filed by the companies with the Taiwan exchanges. The _ytd values are as filed. The _q values are computed by FocusAlpha except in season 1, and quarter_basis says which case each row is.

​
GET /v1/companies/{company_id}/tw/financials

Quarterly income statements and balance sheets, newest first. The route accepts a Taiwan security code such as 2330, a suffixed ticker such as 2330.TW, an ISIN or a company_id directly — there is no need to resolve the identifier first.
​
string
required
A Taiwan security code, a suffixed ticker, an ISIN or a company_id.
​
string
income or balance. Both by default.
​
integer
Fiscal year.
​
integer
TWSE season, 1 to 4.
​
boolean
default:"false"
true adds the line-item detail described above.
​
string
next_cursor from the previous page.
​
integer
default:"40"
Rows per page, between 1 and 1000.
See also Taiwan Cash Flow for the cash-flow statement and balance-sheet detail, Taiwan Monthly Revenue for the monthly filing that leads these statements, Taiwan Foreign Ownership, Taiwan Ownership, and Company Registry for the identifiers.